link-warning: Add copyright notice.
[gnulib.git] / NEWS
1 Important notes
2 ---------------
3
4 User visible incompatible changes
5 ---------------------------------
6
7 Date        Modules         Changes
8
9 2009-12-09  link-warning    The Makefile rules that use $(LINK_WARNING_H) now
10                             must contain an explicit dependency on
11                             $(LINK_WARNING_H).
12
13 2009-11-12  getgroups       These functions now use a signature of gid_t,
14             getugroups      rather than GETGROUPS_T.  This probably has no
15                             effect except on very old platforms.
16
17 2009-11-04  tempname        The gen_tempname function takes an additional
18                             'suffixlen' argument. You can safely pass 0.
19
20 2009-11-04  nproc           The num_processors function now takes an argument.
21
22 2009-11-02  inet_pton       The use of this module now requires linking with
23                             $(INET_PTON_LIB).
24
25 2009-11-02  inet_ntop       The use of this module now requires linking with
26                             $(INET_NTOP_LIB).
27
28 2009-10-10  utimens         The use of this module now requires linking with
29                             $(LIB_CLOCK_GETTIME).
30
31 2009-09-16  canonicalize-lgpl
32                             The include file is changed from "canonicalize.h"
33                             to <stdlib.h>.
34
35 2009-09-04  link-follow     The macro LINK_FOLLOWS_SYMLINK is now tri-state,
36                             rather than only defined to 1.
37
38 2009-09-03  openat          The include files are standardized to POSIX 2008.
39                             For openat, include <fcntl.h>; for
40                             fchmodat, fstatat, and mkdirat, include
41                             <sys/stat.h>; for fchownat and unlinkat,
42                             include <unistd.h>.  For all other
43                             functions provided by this module,
44                             continue to include "openat.h".
45
46 2009-08-30  striconveh      The functions mem_cd_iconveh and str_cd_iconveh
47                             now take an 'iconveh_t *' argument instead of three
48                             iconv_t arguments.
49
50 2009-08-23  tempname        The gen_tempname function takes an additional
51                             'flags' argument. You can safely pass 0.
52
53 2009-08-12  getopt          This module is deprecated. Please choose among
54                             getopt-posix and getopt-gnu. getopt-gnu provides
55                             "long options" and "options with optional
56                             arguments", getopt-posix doesn't.
57
58 2009-06-25  fpurge          The include file is changed from "fpurge.h" to
59                             <stdio.h>.
60
61 2009-04-26  modules/uniconv/u8-conv-from-enc
62             modules/uniconv/u16-conv-from-enc
63             modules/uniconv/u32-conv-from-enc
64                             The calling convention of the functions
65                             u*_conv_from_encoding is changed.
66
67 2009-04-26  modules/uniconv/u8-conv-to-enc
68             modules/uniconv/u16-conv-to-enc
69             modules/uniconv/u32-conv-to-enc
70                             The calling convention of the functions
71                             u*_conv_to_encoding is changed.
72
73 2009-04-24  maintainer-makefile
74                             The maint.mk file was copied from
75                             coreutils, and the old
76                             coverage/gettext/indent rules were
77                             re-added.  If you used 'make syntax-check'
78                             this will add several new checks.  If some
79                             new check is annoying, add the name of the
80                             checks to 'local-checks-to-skip' in your
81                             cfg.mk.
82
83 2009-04-01  visibility      Renamed to lib-symbol-visibility.
84
85 2009-04-01  ld-version-script  Renamed to lib-symbol-versions.
86
87 2009-03-20  close           The substituted variable LIB_CLOSE is removed.
88
89 2009-03-05  filevercmp      Move hidden files up in ordering.
90
91 2009-01-22  c-strtod        This function no longer calls xalloc_die(). If
92             c-strtold       you want to exit the program in case of out-of-
93                             memory, the calling function needs to arrange
94                             for it, like this:
95                                 errno = 0;
96                                 val = c_strtod (...);
97                                 if (val == 0 && errno == ENOMEM)
98                                   xalloc_die ();
99
100 2009-01-17  relocatable-prog  In the Makefile.am or Makefile.in, you now also
101                             need to set RELOCATABLE_STRIP = :.
102
103 2008-12-22  getaddrinfo     When using this module, you now need to link with
104             canon-host      $(GETADDRINFO_LIB).
105
106 2008-12-21  mbiter          The header files "mbiter.h", "mbuiter.h",
107             mbuiter         "mbfile.h" can now be included without checking
108             mbfile          HAVE_MBRTOWC. The macro HAVE_MBRTOWC will no
109                             longer be defined by these modules in a year. If
110                             you want to continue to use it, you need to invoke
111                             AC_FUNC_MBRTOWC yourself.
112
113 2008-11-11  warnings        This module subsumes the file m4/warning.m4 which
114                             was removed.
115
116 2008-10-20  lstat           The include file is changed from "lstat.h" to
117                             <sys/stat.h>.
118
119 2008-10-20  getaddrinfo     The include file is changed from "getaddrinfo.h"
120                             to <netdb.h>.
121
122 2008-10-19  isnanf          The include file is changed from "isnanf.h" to
123                             <math.h>.
124             isnand          The include file is changed from "isnand.h" to
125                             <math.h>.
126             isnanl          The include file is changed from "isnanl.h" to
127                             <math.h>.
128
129 2008-10-18  lchmod          The include file is changed from "lchmod.h" to
130                             <sys/stat.h>.
131
132 2008-10-18  dirfd           The include file is changed from "dirfd.h" to
133                             <dirent.h>.
134
135 2008-10-18  euidaccess      The include file is changed from "euidaccess.h"
136                             to <unistd.h>.
137
138 2008-10-18  getdomainname   The include file is changed from "getdomainname.h"
139                             to <unistd.h>.
140
141 2008-09-28  sockets         When using this module, you now need to link with
142                             $(LIBSOCKET).
143
144 2008-09-24  sys_select      The limitation on `select', introduced 2008-09-23,
145                             was removed.  sys_select now includes a select
146                             wrapper for Winsock.  The wrapper expects socket
147                             and file descriptors to be compatible as arranged
148                             by the sys_socket on MinGW.
149
150 2008-09-23  sys_socket      Under Windows (MinGW), the module now adds
151                             wrappers around Winsock functions, so that
152                             socket descriptors are now compatible with
153                             file descriptors.  In general, this change
154                             will simply improve your code's portability
155                             between POSIX platforms and Windows.  In
156                             particular, you will be able to use ioctl and
157                             close instead of ioctlsocket and closesocket,
158                             and test errno instead of WSAGetLastError ().
159                             On the other hand, you have to audit your code to
160                             remove usage of these Winsock-specific functions.
161
162                             This change does not remove the need to call
163                             the gl_sockets_startup function from the sockets
164                             gnulib module.  Also, for now select is disabled
165                             when you include the sys_socket module; while
166                             the functionality will be restored soon, for
167                             efficiency it is suggested to use the poll system
168                             poll system call and gnulib module instead.
169
170 2008-09-13  EOVERFLOW       The module is removed. Use module errno instead.
171
172 2008-09-01  filename        The module does not define the function
173                             concatenated_filename any more. To get an
174                             equivalent function, use function
175                             xconcatenated_filename from module
176                             'xconcat-filename'.
177
178 2008-08-31  havelib         On Solaris, when searching for 64-bit mode
179                             libraries the directory $prefix/lib is now ignored.
180                             Instead the directory $prefix/lib/64 is searched.
181                             You may need to create a symbolic link for
182                             $prefix/lib/64 if you have 64-bit libraries
183                             installed in $prefix/lib.
184
185 2008-08-19  strverscmp      The include file is changed from "strverscmp.h"
186                             to <string.h>.
187
188 2008-08-14  lock            The include file is changed from "lock.h"
189                             to "glthread/lock.h".
190             tls             The include file is changed from "tls.h"
191                             to "glthread/tls.h".
192
193 2008-07-17  c-stack         The module now requires the addition of
194                             $(LIBCSTACK) or $(LTLIBCSTACK) in Makefile.am,
195                             since it may depend on linking with libsigsegv.
196
197 2008-07-07  isnanf-nolibm   The include file is changed from "isnanf.h"
198                             to "isnanf-nolibm.h".
199             isnand-nolibm   The include file is changed from "isnand.h"
200                             to "isnand-nolibm.h".
201
202 2008-06-10  execute         The execute function takes an additional termsigp
203                             argument. Passing termsigp = NULL is ok.
204             wait-process    The wait_subprocess function takes an additional
205                             termsigp argument. Passing termsigp = NULL is ok.
206
207 2008-05-10  linebreak       The module is split into several modules unilbrk/*.
208                             The include file is changed from "linebreak.h" to
209                             "unilbrk.h". Two functions are renamed:
210                             mbs_possible_linebreaks -> ulc_possible_linebreaks
211                             mbs_width_linebreaks -> ulc_width_linebreaks
212
213 2008-04-28  rpmatch         The include file is now <stdlib.h>.
214
215 2008-04-28  inet_ntop       The include file is changed from "inet_ntop.h"
216                             to <arpa/inet.h>.
217
218 2008-04-28  inet_pton       The include file is changed from "inet_pton.h"
219                             to <arpa/inet.h>.
220
221 2008-03-06  freadahead      The return value's computation has changed. It
222                             now increases by 1 after ungetc.
223
224 2008-01-26  isnan-nolibm    The module name is changed from isnan-nolibm to
225                             isnand-nolibm. The include file is changed from
226                             "isnan.h" to "isnand.h". The function that it
227                             defines is changed from isnan() to isnand().
228
229 2008-01-14  strcasestr      This module now replaces worst-case inefficient
230                             implementations; clients that use controlled
231                             needles and thus do not care about worst-case
232                             efficiency should use the new strcasestr-simple
233                             module instead for smaller code size.
234
235 2008-01-09  alloca-opt      Now defines HAVE_ALLOCA_H only when the system
236                             supplies an <alloca.h>.  Gnulib-using code is now
237                             expected to include <alloca.h> unconditionally.
238                             Non-gnulib-using code can continue to include
239                             <alloca.h> only if HAVE_ALLOCA_H is defined.
240
241 2008-01-08  memmem          This module now replaces worst-case inefficient
242                             implementations; clients that use controlled
243                             needles and thus do not care about worst-case
244                             efficiency should use the new memmem-simple
245                             module instead for smaller code size.
246
247 2007-12-24  setenv          The include file is changed from "setenv.h" to
248                             <stdlib.h>. Also, the unsetenv function is no
249                             longer declared in this module; use the 'unsetenv'
250                             module if you need it.
251
252 2007-12-03  getpagesize     The include file is changed from "getpagesize.h"
253                             to <unistd.h>.
254
255 2007-12-03  strcase         The include file is changed from <string.h> to
256                             <strings.h>.
257
258 2007-10-07  most modules    The license for most modules has changed from
259                             GPLv2+ to GPLv3+, and from LGPLv2+ to LGPLv3+.
260                             A few modules are still under LGPLv2+; see the
261                             module description for the applicable license.
262
263 2007-09-01  linebreak       "linebreak.h" no longer declares the functions
264                             locale_charset, uc_width, u{8,16,32}_width. Use
265                             "uniwidth.h" to get these functions declared.
266
267 2007-08-28  areadlink-with-size
268                             Renamed from mreadlink-with-size.
269                             Function renamed: mreadlink_with_size ->
270                             areadlink_with_size.
271
272 2007-08-22  getdelim, getline
273                             The include file is changed from "getdelim.h"
274                             and "getline.h" to the POSIX 200x <stdio.h>.
275
276 2007-08-18  idcache         Now provides prototypes in "idcache.h".
277
278 2007-08-10  xstrtol         The STRTOL_FATAL_ERROR macro is removed.
279                             Use the new xstrtol_fatal function instead.
280
281 2007-08-04  human           The function human_options no longer reports an
282                             error to standard error; that is now the
283                             caller's responsibility.  It returns an
284                             error code of type enum strtol_error
285                             instead of the integer option value, and stores
286                             the option value via a new int * argument.
287             xstrtol         The first two arguments of STRTOL_FATAL_ERROR
288                             are now an option name and option argument
289                             instead of an option argument and a type string,
290                             STRTOL_FAIL_WARN is removed.
291
292 2007-07-14  gpl, lgpl       New Texinfo versions with no sectioning commands.
293
294 2007-07-10  version-etc     Output now mentions GPLv3+, not GPLv2+.  Use
295                             gnulib-tool --local-dir to override this.
296
297 2007-07-07  wcwidth         The include file is changed from "wcwidth.h" to
298                             <wchar.h>.
299
300 2007-07-02  gpl, lgpl       Renamed to gpl-2.0 and lgpl-2.1 respectively.
301                             (There is also a new module gpl-3.0.)
302
303 2007-06-16  lchown          The include file is changed from "lchown.h" to
304                             <unistd.h>.
305
306 2007-06-09  xallocsa        Renamed to xmalloca. The include file "xallocsa.h"
307                             was remamed to "xmalloca.h". The function was
308                             renamed:
309                               xallocsa -> xmalloca
310
311 2007-06-09  allocsa         Renamed to malloca. The include file "allocsa.h"
312                             was remamed to "malloca.h". The function-like
313                             macros were renamed:
314                               allocsa -> malloca
315                               freesa -> freea
316
317 2007-05-20  utimens         Renamed futimens to gl_futimens, to avoid
318                             conflict with the glibc-2.6-introduced function
319                             that has a different signature.
320
321 2007-05-01  sigprocmask     The module now depends on signal, so replace
322                               #include "sigprocmask.h"
323                             with
324                               #include <signal.h>
325
326 2007-04-06  gettext         The macro HAVE_LONG_DOUBLE is no longer set.
327                             You can replace all its uses with 1, i.e. assume
328                             'long double' as a type exists.
329
330 2007-04-01  arcfour         Renamed to crypto/arcfour.
331             arctwo          Renamed to crypto/arctwo.
332             des             Renamed to crypto/des.
333             gc              Renamed to crypto/gc.
334             gc-arcfour      Renamed to crypto/gc-arcfour.
335             gc-arctwo       Renamed to crypto/gc-arctwo.
336             gc-des          Renamed to crypto/gc-des.
337             gc-hmac-md5     Renamed to crypto/gc-hmac-md5.
338             gc-hmac-sha1    Renamed to crypto/gc-hmac-sha1.
339             gc-md2          Renamed to crypto/gc-md2.
340             gc-md4          Renamed to crypto/gc-md4.
341             gc-md5          Renamed to crypto/gc-md5.
342             gc-pbkdf2-sha1  Renamed to crypto/gc-pbkdf2-sha1.
343             gc-random       Renamed to crypto/gc-random.
344             gc-rijndael     Renamed to crypto/gc-rijndael.
345             gc-sha1         Renamed to crypto/gc-sha1.
346             hmac-md5        Renamed to crypto/hmac-md5.
347             hmac-sha1       Renamed to crypto/hmac-sha1.
348             md2             Renamed to crypto/md2.
349             md4             Renamed to crypto/md4.
350             md5             Renamed to crypto/md5.
351             rijndael        Renamed to crypto/rijndael.
352             sha1            Renamed to crypto/sha1.
353
354 2007-03-27  vasprintf       The module now depends on stdio, so replace
355                                #include "vasprintf.h"
356                             with
357                                #include <stdio.h>
358
359 2007-03-24  tsearch         The include file is changed from "tsearch.h" to
360                             <search.h>.
361
362 2007-03-24  utf8-ucs4       The include file is changed from "utf8-ucs4.h"
363                             to "unistr.h".
364             utf8-ucs4-unsafe  The include file is changed from
365                             "utf8-ucs4-unsafe.h" to "unistr.h".
366             utf16-ucs4      The include file is changed from "utf16-ucs4.h"
367                             to "unistr.h".
368             utf16-ucs4-unsafe  The include file is changed from
369                             "utf16-ucs4-unsafe.h" to "unistr.h".
370             ucs4-utf8       The include file is changed from "ucs4-utf8.h"
371                             to "unistr.h".
372             ucs4-utf16      The include file is changed from "ucs4-utf16.h"
373                             to "unistr.h".
374
375 2007-03-19  iconvme         The module is removed. Use module striconv instead:
376                             iconv_string -> str_iconv
377                             iconv_alloc -> str_cd_iconv (with reversed
378                                            arguments)
379
380 2007-03-15  list            The functions gl_list_create_empty and
381             array-list      gl_list_create now take an extra fourth argument.
382             carray-list     You can pass NULL.
383             linked-list
384             linkedhash-list
385             avltree-list
386             rbtree-list
387             avltreehash-list
388             rbtreehash-list
389
390 2007-03-15  oset            The function gl_oset_create_empty now takes a
391             array-oset      third argument. You can pass NULL.
392             avltree-oset
393             rbtree-oset
394
395 2007-03-12  des             The types and functions in lib/des.h have been
396             gc-des          renamed:
397
398                             des_ctx -> gl_des_ctx, tripledes_ctx -> gl_3des_ctx,
399                             des_is_weak_key -> gl_des_is_weak_key,
400                             des_setkey -> gl_des_setkey,
401                             des_makekey -> gl_des_makekey,
402                             des_ecb_crypt -> gl_des_ecb_crypt,
403                             des_ecb_encrypt -> gl_des_ecb_encrypt,
404                             des_ecb_decrypt -> gl_des_ecb_decrypt,
405                             tripledes_set2keys -> gl_3des_set2keys,
406                             tripledes_set3keys -> gl_3des_set3keys,
407                             tripledes_makekey -> gl_3des_makekey,
408                             tripledes_ecb_crypt -> gl_3des_ecb_crypt.
409
410                             Also consider using the "gc-des" buffer instead of
411                             using the "des" module directly.
412
413 2007-02-28  xreadlink       The module xreadlink was renamed to
414                             xreadlink-with-size. The function was renamed:
415                             xreadlink -> xreadlink_with_size.
416
417 2007-02-18  exit            The modules now depend on stdlib, so replace
418             mkdtemp           #include "exit.h"
419             mkstemp           #include "mkdtemp.h"
420                               #include "mkstemp.h"
421                             with
422                               #include <stdlib.h>
423
424 2007-01-26  strdup          The module now depends on string, so replace
425                               #include "strdup.h"
426                             with
427                               #include <string.h>
428
429 # This is for Emacs.
430 # Local Variables:
431 # indent-tabs-mode: nil
432 # whitespace-check-buffer-indent: nil
433 # End: