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