\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
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
* Comments::
* Header files::
* Out of memory handling::
+* Obsolete modules::
* Library version handling::
* Windows sockets::
* Libtool and Windows::
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
@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
* jrand48_r::
* lcong48_r::
* lrand48_r::
+* mkostemp::
* mrand48_r::
* nrand48_r::
* on_exit::
@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
@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
* brk::
* chroot::
* daemon::
+* dup3::
* endusershell::
* euidaccess::
* get_current_dir_name::
* getresuid::
* getusershell::
* group_member::
+* pipe2::
* profil::
* revoke::
* sbrk::
@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
@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
@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::
@findex alloca
@include alloca-opt.texi
+@include safe-alloc.texi
+
@node String Functions in C Locale
@section Character and String Functions in C Locale
@include c-strtold.texi
@include quote.texi
+
@include error.texi
+
@include gcd.texi
-@include relocatable-maint.texi
@node Regular expressions
@section Regular expressions
@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