Reference some new glibc functions.

[pspp] / doc / gnulib.texi

diff --git a/doc/gnulib.texi b/doc/gnulib.texi
index 845f083eb574717b96c904353f5e0b0061be1806..bee03521d36d8b0b2fc10aac77f3706703485902 100644 (file)
--- a/doc/gnulib.texi
+++ b/doc/gnulib.texi
@@ -1,5 +1,4 @@
 \input texinfo   @c -*-texinfo-*-
-@comment $Id: gnulib.texi,v 1.44 2007-09-09 13:20:45 haible Exp $
 @comment %**start of header
 @setfilename gnulib.info
 @settitle GNU Gnulib
@@ -18,8 +17,7 @@ This manual is for GNU Gnulib (updated @value{UPDATED}),
 which is a library of common routines intended to be shared at the
 source level.
 
-Copyright @copyright{} 2004, 2005, 2006, 2007, 2008 Free Software
-Foundation, Inc.
+Copyright @copyright{} 2004-2009 Free Software Foundation, Inc.
 
 Permission is granted to copy, distribute and/or modify this document
 under the terms of the GNU Free Documentation License, Version 1.3 or
@@ -122,6 +120,7 @@ Resources:
 * Comments::
 * Header files::
 * Out of memory handling::
+* Obsolete modules::
 * Library version handling::
 * Windows sockets::
 * Libtool and Windows::
@@ -263,6 +262,31 @@ must be taken to not allocate more memory, as that will likely also
 fail.
 
 
+@node Obsolete modules
+@section Obsolete modules
+
+@cindex Obsolete modules
+Modules can be marked obsolete.  This means that the problems they fix
+don't occur any more on the platforms that are reasonable porting targets
+now.  @code{gnulib-tool} warns when obsolete modules are mentioned on the
+command line, and by default ignores dependencies from modules to obsolete
+modules.  When you pass the option @code{--with-obsolete} to
+@code{gnulib-tool}, dependencies to obsolete modules will be included,
+however, unless blocked through an @code{--avoid} option.  This option
+is useful if your package should be portable even to very old platforms.
+
+In order to mark a module obsolete, you need to add this to the module
+description:
+
+@example
+Status:
+obsolete
+
+Notice:
+This module is obsolete.
+@end example
+
+
 @node Library version handling
 @section Library version handling
 
@@ -888,10 +912,13 @@ by Gnulib.
 * fabs::
 * fabsf::
 * fabsl::
+* faccessat::
 * fattach::
 * fchdir::
 * fchmod::
+* fchmodat::
 * fchown::
+* fchownat::
 * fclose::
 * fcntl::
 * fdatasync::
@@ -900,6 +927,7 @@ by Gnulib.
 * fdimf::
 * fdiml::
 * fdopen::
+* fdopendir::
 * feclearexcept::
 * fegetenv::
 * fegetexceptflag::
@@ -963,6 +991,7 @@ by Gnulib.
 * fseeko::
 * fsetpos::
 * fstat::
+* fstatat::
 * fstatvfs::
 * fsync::
 * ftell::
@@ -972,6 +1001,7 @@ by Gnulib.
 * ftrylockfile::
 * ftw::
 * funlockfile::
+* futimens::
 * fwide::
 * fwprintf::
 * fwrite::
@@ -1155,6 +1185,7 @@ by Gnulib.
 * lgammaf::
 * lgammal::
 * link::
+* linkat::
 * lio_listio::
 * listen::
 * llabs::
@@ -1211,9 +1242,12 @@ by Gnulib.
 * memmove::
 * memset::
 * mkdir::
+* mkdirat::
 * mkdtemp::
 * mkfifo::
+* mkfifoat::
 * mknod::
+* mknodat::
 * mkstemp::
 * mktime::
 * mlock::
@@ -1264,9 +1298,11 @@ by Gnulib.
 * ntohl::
 * ntohs::
 * open::
+* openat::
 * opendir::
 * openlog::
 * open_memstream::
+* open_wmemstream::
 * optarg::
 * opterr::
 * optind::
@@ -1363,6 +1399,7 @@ by Gnulib.
 * pread::
 * printf::
 * pselect::
+* psiginfo::
 * psignal::
 * pthread_atfork::
 * pthread_attr_destroy::
@@ -1417,6 +1454,7 @@ by Gnulib.
 * pthread_key_create::
 * pthread_key_delete::
 * pthread_kill::
+* pthread_mutex_consistent::
 * pthread_mutex_destroy::
 * pthread_mutex_getprioceiling::
 * pthread_mutex_init::
@@ -1429,11 +1467,13 @@ by Gnulib.
 * pthread_mutexattr_getprioceiling::
 * pthread_mutexattr_getprotocol::
 * pthread_mutexattr_getpshared::
+* pthread_mutexattr_getrobust::
 * pthread_mutexattr_gettype::
 * pthread_mutexattr_init::
 * pthread_mutexattr_setprioceiling::
 * pthread_mutexattr_setprotocol::
 * pthread_mutexattr_setpshared::
+* pthread_mutexattr_setrobust::
 * pthread_mutexattr_settype::
 * pthread_once::
 * pthread_rwlock_destroy::
@@ -1485,6 +1525,7 @@ by Gnulib.
 * readdir::
 * readdir_r::
 * readlink::
+* readlinkat::
 * readv::
 * realloc::
 * realpath::
@@ -1504,6 +1545,7 @@ by Gnulib.
 * remquof::
 * remquol::
 * rename::
+* renameat::
 * rewind::
 * rewinddir::
 * rint::
@@ -1645,6 +1687,7 @@ by Gnulib.
 * strcspn::
 * strdup::
 * strerror::
+* strerror_l::
 * strerror_r::
 * strfmon::
 * strfmon_l::
@@ -1681,6 +1724,7 @@ by Gnulib.
 * swprintf::
 * swscanf::
 * symlink::
+* symlinkat::
 * sync::
 * sysconf::
 * syslog::
@@ -1744,10 +1788,12 @@ by Gnulib.
 * ungetc::
 * ungetwc::
 * unlink::
+* unlinkat::
 * unlockpt::
 * unsetenv::
 * uselocale::
 * utime::
+* utimensat::
 * utimes::
 * va_arg::
 * va_copy::
@@ -2059,10 +2105,13 @@ by Gnulib.
 @include posix-functions/fabs.texi
 @include posix-functions/fabsf.texi
 @include posix-functions/fabsl.texi
+@include posix-functions/faccessat.texi
 @include posix-functions/fattach.texi
 @include posix-functions/fchdir.texi
 @include posix-functions/fchmod.texi
+@include posix-functions/fchmodat.texi
 @include posix-functions/fchown.texi
+@include posix-functions/fchownat.texi
 @include posix-functions/fclose.texi
 @include posix-functions/fcntl.texi
 @include posix-functions/fdatasync.texi
@@ -2071,6 +2120,7 @@ by Gnulib.
 @include posix-functions/fdimf.texi
 @include posix-functions/fdiml.texi
 @include posix-functions/fdopen.texi
+@include posix-functions/fdopendir.texi
 @include posix-functions/feclearexcept.texi
 @include posix-functions/fegetenv.texi
 @include posix-functions/fegetexceptflag.texi
@@ -2134,6 +2184,7 @@ by Gnulib.
 @include posix-functions/fseeko.texi
 @include posix-functions/fsetpos.texi
 @include posix-functions/fstat.texi
+@include posix-functions/fstatat.texi
 @include posix-functions/fstatvfs.texi
 @include posix-functions/fsync.texi
 @include posix-functions/ftell.texi
@@ -2143,6 +2194,7 @@ by Gnulib.
 @include posix-functions/ftrylockfile.texi
 @include posix-functions/ftw.texi
 @include posix-functions/funlockfile.texi
+@include posix-functions/futimens.texi
 @include posix-functions/fwide.texi
 @include posix-functions/fwprintf.texi
 @include posix-functions/fwrite.texi
@@ -2326,6 +2378,7 @@ by Gnulib.
 @include posix-functions/lgammaf.texi
 @include posix-functions/lgammal.texi
 @include posix-functions/link.texi
+@include posix-functions/linkat.texi
 @include posix-functions/lio_listio.texi
 @include posix-functions/listen.texi
 @include posix-functions/llabs.texi
@@ -2382,9 +2435,12 @@ by Gnulib.
 @include posix-functions/memmove.texi
 @include posix-functions/memset.texi
 @include posix-functions/mkdir.texi
+@include posix-functions/mkdirat.texi
 @include posix-functions/mkdtemp.texi
 @include posix-functions/mkfifo.texi
+@include posix-functions/mkfifoat.texi
 @include posix-functions/mknod.texi
+@include posix-functions/mknodat.texi
 @include posix-functions/mkstemp.texi
 @include posix-functions/mktime.texi
 @include posix-functions/mlock.texi
@@ -2435,9 +2491,11 @@ by Gnulib.
 @include posix-functions/ntohl.texi
 @include posix-functions/ntohs.texi
 @include posix-functions/open.texi
+@include posix-functions/openat.texi
 @include posix-functions/opendir.texi
 @include posix-functions/openlog.texi
 @include posix-functions/open_memstream.texi
+@include posix-functions/open_wmemstream.texi
 @include posix-functions/optarg.texi
 @include posix-functions/opterr.texi
 @include posix-functions/optind.texi
@@ -2534,6 +2592,7 @@ by Gnulib.
 @include posix-functions/pread.texi
 @include posix-functions/printf.texi
 @include posix-functions/pselect.texi
+@include posix-functions/psiginfo.texi
 @include posix-functions/psignal.texi
 @include posix-functions/pthread_atfork.texi
 @include posix-functions/pthread_attr_destroy.texi
@@ -2588,6 +2647,7 @@ by Gnulib.
 @include posix-functions/pthread_key_create.texi
 @include posix-functions/pthread_key_delete.texi
 @include posix-functions/pthread_kill.texi
+@include posix-functions/pthread_mutex_consistent.texi
 @include posix-functions/pthread_mutex_destroy.texi
 @include posix-functions/pthread_mutex_getprioceiling.texi
 @include posix-functions/pthread_mutex_init.texi
@@ -2600,11 +2660,13 @@ by Gnulib.
 @include posix-functions/pthread_mutexattr_getprioceiling.texi
 @include posix-functions/pthread_mutexattr_getprotocol.texi
 @include posix-functions/pthread_mutexattr_getpshared.texi
+@include posix-functions/pthread_mutexattr_getrobust.texi
 @include posix-functions/pthread_mutexattr_gettype.texi
 @include posix-functions/pthread_mutexattr_init.texi
 @include posix-functions/pthread_mutexattr_setprioceiling.texi
 @include posix-functions/pthread_mutexattr_setprotocol.texi
 @include posix-functions/pthread_mutexattr_setpshared.texi
+@include posix-functions/pthread_mutexattr_setrobust.texi
 @include posix-functions/pthread_mutexattr_settype.texi
 @include posix-functions/pthread_once.texi
 @include posix-functions/pthread_rwlock_destroy.texi
@@ -2656,6 +2718,7 @@ by Gnulib.
 @include posix-functions/readdir.texi
 @include posix-functions/readdir_r.texi
 @include posix-functions/readlink.texi
+@include posix-functions/readlinkat.texi
 @include posix-functions/readv.texi
 @include posix-functions/realloc.texi
 @include posix-functions/realpath.texi
@@ -2675,6 +2738,7 @@ by Gnulib.
 @include posix-functions/remquof.texi
 @include posix-functions/remquol.texi
 @include posix-functions/rename.texi
+@include posix-functions/renameat.texi
 @include posix-functions/rewind.texi
 @include posix-functions/rewinddir.texi
 @include posix-functions/rint.texi
@@ -2816,6 +2880,7 @@ by Gnulib.
 @include posix-functions/strcspn.texi
 @include posix-functions/strdup.texi
 @include posix-functions/strerror.texi
+@include posix-functions/strerror_l.texi
 @include posix-functions/strerror_r.texi
 @include posix-functions/strfmon.texi
 @include posix-functions/strfmon_l.texi
@@ -2852,6 +2917,7 @@ by Gnulib.
 @include posix-functions/swprintf.texi
 @include posix-functions/swscanf.texi
 @include posix-functions/symlink.texi
+@include posix-functions/symlinkat.texi
 @include posix-functions/sync.texi
 @include posix-functions/sysconf.texi
 @include posix-functions/syslog.texi
@@ -2915,10 +2981,12 @@ by Gnulib.
 @include posix-functions/ungetc.texi
 @include posix-functions/ungetwc.texi
 @include posix-functions/unlink.texi
+@include posix-functions/unlinkat.texi
 @include posix-functions/unlockpt.texi
 @include posix-functions/unsetenv.texi
 @include posix-functions/uselocale.texi
 @include posix-functions/utime.texi
+@include posix-functions/utimensat.texi
 @include posix-functions/utimes.texi
 @include posix-functions/va_arg.texi
 @include posix-functions/va_copy.texi
@@ -3564,9 +3632,11 @@ This list of functions is sorted according to the header that declares them.
 @section Glibc Extensions to @code{<fcntl.h>}
 
 @menu
+* fallocate::
 * readahead::
 @end menu
 
+@include glibc-functions/fallocate.texi
 @include glibc-functions/readahead.texi
 
 @node Glibc fenv.h
@@ -4993,6 +5063,7 @@ This list of functions is sorted according to the header that declares them.
 * jrand48_r::
 * lcong48_r::
 * lrand48_r::
+* mkostemp::
 * mrand48_r::
 * nrand48_r::
 * on_exit::
@@ -5033,6 +5104,7 @@ This list of functions is sorted according to the header that declares them.
 @include glibc-functions/jrand48_r.texi
 @include glibc-functions/lcong48_r.texi
 @include glibc-functions/lrand48_r.texi
+@include glibc-functions/mkostemp.texi
 @include glibc-functions/mrand48_r.texi
 @include glibc-functions/nrand48_r.texi
 @include glibc-functions/on_exit.texi
@@ -5300,9 +5372,11 @@ This list of functions is sorted according to the header that declares them.
 @section Glibc Extensions to @code{<sys/socket.h>}
 
 @menu
+* accept4::
 * isfdtype::
 @end menu
 
+@include glibc-functions/accept4.texi
 @include glibc-functions/isfdtype.texi
 
 @node Glibc sys/stat.h
@@ -5585,6 +5659,7 @@ This list of functions is sorted according to the header that declares them.
 * brk::
 * chroot::
 * daemon::
+* dup3::
 * endusershell::
 * euidaccess::
 * get_current_dir_name::
@@ -5596,6 +5671,7 @@ This list of functions is sorted according to the header that declares them.
 * getresuid::
 * getusershell::
 * group_member::
+* pipe2::
 * profil::
 * revoke::
 * sbrk::
@@ -5615,6 +5691,7 @@ This list of functions is sorted according to the header that declares them.
 @include glibc-functions/brk.texi
 @include glibc-functions/chroot.texi
 @include glibc-functions/daemon.texi
+@include glibc-functions/dup3.texi
 @include glibc-functions/endusershell.texi
 @include glibc-functions/euidaccess.texi
 @include glibc-functions/get_current_dir_name.texi
@@ -5626,6 +5703,7 @@ This list of functions is sorted according to the header that declares them.
 @include glibc-functions/getresuid.texi
 @include glibc-functions/getusershell.texi
 @include glibc-functions/group_member.texi
+@include glibc-functions/pipe2.texi
 @include glibc-functions/profil.texi
 @include glibc-functions/revoke.texi
 @include glibc-functions/sbrk.texi
@@ -5746,11 +5824,16 @@ This list of functions is sorted according to the header that declares them.
 @menu
 * alloca::
 * alloca-opt::
+* Safe Allocation Macros::
 * String Functions in C Locale::
 * Quoting::
 * error and progname::
 * gcd::
 * Regular expressions::
+* Searching for Libraries::
+* Exported Symbols of Shared Libraries::
+* LD Version Scripts::
+* Visual Studio Compatibility::
 * Supporting Relocation::
 * func::
 * warnings::
@@ -5767,6 +5850,8 @@ This list of functions is sorted according to the header that declares them.
 @findex alloca
 @include alloca-opt.texi
 
+@include safe-alloc.texi
+
 @node String Functions in C Locale
 @section Character and String Functions in C Locale
 
@@ -5820,9 +5905,10 @@ ASCII characters.
 @include c-strtold.texi
 
 @include quote.texi
+
 @include error.texi
+
 @include gcd.texi
-@include relocatable-maint.texi
 
 @node Regular expressions
 @section Regular expressions
@@ -5834,13 +5920,22 @@ generated automatically.
 
 @include regexprops-generic.texi
 
+@include havelib.texi
+
+@include lib-symbol-visibility.texi
+
+@include ld-version-script.texi
+
+@include ld-output-def.texi
+
+@include relocatable-maint.texi
+
 @include func.texi
 
 @include warnings.texi
 
 @include manywarnings.texi
 
-
 @node GNU Free Documentation License
 @appendix GNU Free Documentation License