Keep the extern-inline macros closer together.

[gnulib.git] / doc / gnulib.texi

diff --git a/doc/gnulib.texi b/doc/gnulib.texi
index 1ab056f..8725634 100644 (file)
--- a/doc/gnulib.texi
+++ b/doc/gnulib.texi
@@ -90,7 +90,7 @@ If you need this particular \thing\, you may write to
 @node Introduction
 @chapter Introduction
 
 @node Introduction
 @chapter Introduction
 

-Gnulib is a source code library. It provides basic functionalities to
+Gnulib is a source code library. It provides basic functionality to

 programs and libraries.  Currently (as of October 2006) more than 30
 packages make use of Gnulib.
 
 programs and libraries.  Currently (as of October 2006) more than 30
 packages make use of Gnulib.
 


@@ -389,7 +389,7 @@ required module automatically, unless it is specified with option
 @code{--avoid} or it is marked as obsolete and the option
 @code{--with-obsolete} is not given.
 
 @code{--avoid} or it is marked as obsolete and the option
 @code{--with-obsolete} is not given.
 

-A test modules @code{foo-tests} implicity depends on the corresponding non-test
+A test modules @code{foo-tests} implicitly depends on the corresponding non-test

 module @code{foo}.  @code{foo} implicitly depends on @code{foo-tests} if the
 latter exists and if the option @code{--with-tests} has been given.
 
 module @code{foo}.  @code{foo} implicitly depends on @code{foo-tests} if the
 latter exists and if the option @code{--with-tests} has been given.
 


@@ -1194,6 +1194,7 @@ which (known) portability problems are not worked around by Gnulib.
 * stdint.h::
 * stdio.h::
 * stdlib.h::
 * stdint.h::
 * stdio.h::
 * stdlib.h::

+* stdnoreturn.h::

 * string.h::
 * strings.h::
 * stropts.h::
 * string.h::
 * strings.h::
 * stropts.h::


@@ -1221,6 +1222,7 @@ which (known) portability problems are not worked around by Gnulib.
 * tgmath.h::
 * time.h::
 * trace.h::
 * tgmath.h::
 * time.h::
 * trace.h::

+* uchar.h::

 * ucontext.h::
 * ulimit.h::
 * unistd.h::
 * ucontext.h::
 * ulimit.h::
 * unistd.h::


@@ -1281,6 +1283,7 @@ which (known) portability problems are not worked around by Gnulib.
 @include posix-headers/stdint.texi
 @include posix-headers/stdio.texi
 @include posix-headers/stdlib.texi
 @include posix-headers/stdint.texi
 @include posix-headers/stdio.texi
 @include posix-headers/stdlib.texi

+@include posix-headers/stdnoreturn.texi

 @include posix-headers/string.texi
 @include posix-headers/strings.texi
 @include posix-headers/stropts.texi
 @include posix-headers/string.texi
 @include posix-headers/strings.texi
 @include posix-headers/stropts.texi


@@ -1308,6 +1311,7 @@ which (known) portability problems are not worked around by Gnulib.
 @include posix-headers/tgmath.texi
 @include posix-headers/time.texi
 @include posix-headers/trace.texi
 @include posix-headers/tgmath.texi
 @include posix-headers/time.texi
 @include posix-headers/trace.texi

+@include posix-headers/uchar.texi

 @include posix-headers/ucontext.texi
 @include posix-headers/ulimit.texi
 @include posix-headers/unistd.texi
 @include posix-headers/ucontext.texi
 @include posix-headers/ulimit.texi
 @include posix-headers/unistd.texi


@@ -1357,6 +1361,7 @@ by Gnulib.
 * aio_suspend::
 * aio_write::
 * alarm::
 * aio_suspend::
 * aio_write::
 * alarm::

+* aligned_alloc::

 * alphasort::
 * asctime::
 * asctime_r::
 * alphasort::
 * asctime::
 * asctime_r::


@@ -1385,6 +1390,8 @@ by Gnulib.
 * bind::
 * bsearch::
 * btowc::
 * bind::
 * bsearch::
 * btowc::

+* c16rtomb::
+* c32rtomb::

 * cabs::
 * cabsf::
 * cabsl::
 * cabs::
 * cabsf::
 * cabsl::


@@ -1870,6 +1877,8 @@ by Gnulib.
 * malloc::
 * mblen::
 * mbrlen::
 * malloc::
 * mblen::
 * mbrlen::

+* mbrtoc16::
+* mbrtoc32::

 * mbrtowc::
 * mbsinit::
 * mbsnrtowcs::
 * mbrtowc::
 * mbsinit::
 * mbsnrtowcs::


@@ -2158,6 +2167,7 @@ by Gnulib.
 * putwchar::
 * pwrite::
 * qsort::
 * putwchar::
 * pwrite::
 * qsort::

+* quick_exit::

 * raise::
 * rand::
 * rand_r::
 * raise::
 * rand::
 * rand_r::


@@ -2550,6 +2560,7 @@ by Gnulib.
 @include posix-functions/aio_suspend.texi
 @include posix-functions/aio_write.texi
 @include posix-functions/alarm.texi
 @include posix-functions/aio_suspend.texi
 @include posix-functions/aio_write.texi
 @include posix-functions/alarm.texi

+@include posix-functions/aligned_alloc.texi

 @include posix-functions/alphasort.texi
 @include posix-functions/asctime.texi
 @include posix-functions/asctime_r.texi
 @include posix-functions/alphasort.texi
 @include posix-functions/asctime.texi
 @include posix-functions/asctime_r.texi


@@ -2578,6 +2589,8 @@ by Gnulib.
 @include posix-functions/bind.texi
 @include posix-functions/bsearch.texi
 @include posix-functions/btowc.texi
 @include posix-functions/bind.texi
 @include posix-functions/bsearch.texi
 @include posix-functions/btowc.texi

+@include posix-functions/c16rtomb.texi
+@include posix-functions/c32rtomb.texi

 @include posix-functions/cabs.texi
 @include posix-functions/cabsf.texi
 @include posix-functions/cabsl.texi
 @include posix-functions/cabs.texi
 @include posix-functions/cabsf.texi
 @include posix-functions/cabsl.texi


@@ -3063,6 +3076,8 @@ by Gnulib.
 @include posix-functions/malloc.texi
 @include posix-functions/mblen.texi
 @include posix-functions/mbrlen.texi
 @include posix-functions/malloc.texi
 @include posix-functions/mblen.texi
 @include posix-functions/mbrlen.texi

+@include posix-functions/mbrtoc16.texi
+@include posix-functions/mbrtoc32.texi

 @include posix-functions/mbrtowc.texi
 @include posix-functions/mbsinit.texi
 @include posix-functions/mbsnrtowcs.texi
 @include posix-functions/mbrtowc.texi
 @include posix-functions/mbsinit.texi
 @include posix-functions/mbsnrtowcs.texi


@@ -3351,6 +3366,7 @@ by Gnulib.
 @include posix-functions/putwchar.texi
 @include posix-functions/pwrite.texi
 @include posix-functions/qsort.texi
 @include posix-functions/putwchar.texi
 @include posix-functions/pwrite.texi
 @include posix-functions/qsort.texi

+@include posix-functions/quick_exit.texi

 @include posix-functions/raise.texi
 @include posix-functions/rand.texi
 @include posix-functions/rand_r.texi
 @include posix-functions/raise.texi
 @include posix-functions/rand.texi
 @include posix-functions/rand_r.texi


@@ -3943,6 +3959,7 @@ This list of functions is sorted according to the header that declares them.
 * Glibc string.h::
 * Glibc sys/capability.h::
 * Glibc sys/epoll.h::
 * Glibc string.h::
 * Glibc sys/capability.h::
 * Glibc sys/epoll.h::

+* Glibc sys/fanotify.h::

 * Glibc sys/file.h::
 * Glibc sys/fsuid.h::
 * Glibc sys/gmon.h::
 * Glibc sys/file.h::
 * Glibc sys/fsuid.h::
 * Glibc sys/gmon.h::


@@ -3957,6 +3974,7 @@ This list of functions is sorted according to the header that declares them.
 * Glibc sys/ptrace.h::
 * Glibc sys/quota.h::
 * Glibc sys/reboot.h::
 * Glibc sys/ptrace.h::
 * Glibc sys/quota.h::
 * Glibc sys/reboot.h::

+* Glibc sys/resource.h::

 * Glibc sys/sem.h::
 * Glibc sys/sendfile.h::
 * Glibc sys/socket.h::
 * Glibc sys/sem.h::
 * Glibc sys/sendfile.h::
 * Glibc sys/socket.h::


@@ -4166,10 +4184,12 @@ This list of functions is sorted according to the header that declares them.
 
 @menu
 * getdirentries::
 
 @menu
 * getdirentries::

+* scandirat::

 * versionsort::
 @end menu
 
 @include glibc-functions/getdirentries.texi
 * versionsort::
 @end menu
 
 @include glibc-functions/getdirentries.texi

+@include glibc-functions/scandirat.texi

 @include glibc-functions/versionsort.texi
 
 @node Glibc dlfcn.h
 @include glibc-functions/versionsort.texi
 
 @node Glibc dlfcn.h


@@ -4280,11 +4300,15 @@ This list of functions is sorted according to the header that declares them.
 
 @menu
 * fallocate::
 
 @menu
 * fallocate::

+* name_to_handle_at::

 * readahead::
 * readahead::

+* open_by_handle_at::

 @end menu
 
 @include glibc-functions/fallocate.texi
 @end menu
 
 @include glibc-functions/fallocate.texi

+@include glibc-functions/name_to_handle_at.texi

 @include glibc-functions/readahead.texi
 @include glibc-functions/readahead.texi

+@include glibc-functions/open_by_handle_at.texi

 
 @node Glibc fenv.h
 @section Glibc Extensions to @code{<fenv.h>}
 
 @node Glibc fenv.h
 @section Glibc Extensions to @code{<fenv.h>}


@@ -4772,6 +4796,19 @@ This list of functions is sorted according to the header that declares them.
 * inet6_option_init::
 * inet6_option_next::
 * inet6_option_space::
 * inet6_option_init::
 * inet6_option_next::
 * inet6_option_space::

+* inet6_opt_append::
+* inet6_opt_find::
+* inet6_opt_finish::
+* inet6_opt_get_val::
+* inet6_opt_init::
+* inet6_opt_next::
+* inet6_opt_set_val::
+* inet6_rth_add::
+* inet6_rth_getaddr::
+* inet6_rth_init::
+* inet6_rth_reverse::
+* inet6_rth_segments::
+* inet6_rth_space::

 * setipv4sourcefilter::
 * setsourcefilter::
 @end menu
 * setipv4sourcefilter::
 * setsourcefilter::
 @end menu


@@ -4787,6 +4824,19 @@ This list of functions is sorted according to the header that declares them.
 @include glibc-functions/inet6_option_init.texi
 @include glibc-functions/inet6_option_next.texi
 @include glibc-functions/inet6_option_space.texi
 @include glibc-functions/inet6_option_init.texi
 @include glibc-functions/inet6_option_next.texi
 @include glibc-functions/inet6_option_space.texi

+@include glibc-functions/inet6_opt_append.texi
+@include glibc-functions/inet6_opt_find.texi
+@include glibc-functions/inet6_opt_finish.texi
+@include glibc-functions/inet6_opt_get_val.texi
+@include glibc-functions/inet6_opt_init.texi
+@include glibc-functions/inet6_opt_next.texi
+@include glibc-functions/inet6_opt_set_val.texi
+@include glibc-functions/inet6_rth_add.texi
+@include glibc-functions/inet6_rth_getaddr.texi
+@include glibc-functions/inet6_rth_init.texi
+@include glibc-functions/inet6_rth_reverse.texi
+@include glibc-functions/inet6_rth_segments.texi
+@include glibc-functions/inet6_rth_space.texi

 @include glibc-functions/setipv4sourcefilter.texi
 @include glibc-functions/setsourcefilter.texi
 
 @include glibc-functions/setipv4sourcefilter.texi
 @include glibc-functions/setsourcefilter.texi
 


@@ -5601,11 +5651,13 @@ This list of functions is sorted according to the header that declares them.
 * clone::
 * sched_getaffinity::
 * sched_setaffinity::
 * clone::
 * sched_getaffinity::
 * sched_setaffinity::

+* setns::

 @end menu
 
 @include glibc-functions/clone.texi
 @include glibc-functions/sched_getaffinity.texi
 @include glibc-functions/sched_setaffinity.texi
 @end menu
 
 @include glibc-functions/clone.texi
 @include glibc-functions/sched_getaffinity.texi
 @include glibc-functions/sched_setaffinity.texi

+@include glibc-functions/setns.texi

 
 @node Glibc search.h
 @section Glibc Extensions to @code{<search.h>}
 
 @node Glibc search.h
 @section Glibc Extensions to @code{<search.h>}


@@ -5806,7 +5858,6 @@ This list of functions is sorted according to the header that declares them.
 * qfcvt_r::
 * qgcvt::
 * qsort_r::
 * qfcvt_r::
 * qgcvt::
 * qsort_r::

-* quick_exit::

 * random_r::
 * rpmatch::
 * seed48_r::
 * random_r::
 * rpmatch::
 * seed48_r::


@@ -5851,7 +5902,6 @@ This list of functions is sorted according to the header that declares them.
 @include glibc-functions/qfcvt_r.texi
 @include glibc-functions/qgcvt.texi
 @include glibc-functions/qsort_r.texi
 @include glibc-functions/qfcvt_r.texi
 @include glibc-functions/qgcvt.texi
 @include glibc-functions/qsort_r.texi

-@include glibc-functions/quick_exit.texi

 @include glibc-functions/random_r.texi
 @include glibc-functions/rpmatch.texi
 @include glibc-functions/seed48_r.texi
 @include glibc-functions/random_r.texi
 @include glibc-functions/rpmatch.texi
 @include glibc-functions/seed48_r.texi


@@ -5930,6 +5980,17 @@ This list of functions is sorted according to the header that declares them.
 @include glibc-functions/epoll_ctl.texi
 @include glibc-functions/epoll_wait.texi
 
 @include glibc-functions/epoll_ctl.texi
 @include glibc-functions/epoll_wait.texi
 

+@node Glibc sys/fanotify.h
+@section Glibc @code{<sys/fanotify.h>}
+
+@menu
+* fanotify_init::
+* fanotify_mark::
+@end menu
+
+@include glibc-functions/fanotify_init.texi
+@include glibc-functions/fanotify_mark.texi
+

 @node Glibc sys/file.h
 @section Glibc @code{<sys/file.h>}
 
 @node Glibc sys/file.h
 @section Glibc @code{<sys/file.h>}
 


@@ -6079,8 +6140,14 @@ This list of functions is sorted according to the header that declares them.
 
 @include glibc-functions/reboot.texi
 
 
 @include glibc-functions/reboot.texi
 

-@c @node Glibc sys/resource.h
-@c @section Glibc Extensions to @code{<sys/resource.h>}
+@node Glibc sys/resource.h
+@section Glibc Extensions to @code{<sys/resource.h>}
+
+@menu
+* prlimit::
+@end menu
+
+@include glibc-functions/prlimit.texi

 
 @c @node Glibc sys/select.h
 @c @section Glibc Extensions to @code{<sys/select.h>}
 
 @c @node Glibc sys/select.h
 @c @section Glibc Extensions to @code{<sys/select.h>}


@@ -6112,10 +6179,14 @@ This list of functions is sorted according to the header that declares them.
 @menu
 * accept4::
 * isfdtype::
 @menu
 * accept4::
 * isfdtype::

+* recvmmsg::
+* sendmmsg::

 @end menu
 
 @include glibc-functions/accept4.texi
 @include glibc-functions/isfdtype.texi
 @end menu
 
 @include glibc-functions/accept4.texi
 @include glibc-functions/isfdtype.texi

+@include glibc-functions/recvmmsg.texi
+@include glibc-functions/sendmmsg.texi

 
 @node Glibc sys/stat.h
 @section Glibc Extensions to @code{<sys/stat.h>}
 
 @node Glibc sys/stat.h
 @section Glibc Extensions to @code{<sys/stat.h>}


@@ -6229,11 +6300,13 @@ This list of functions is sorted according to the header that declares them.
 * adjtimex::
 * ntp_adjtime::
 * ntp_gettime::
 * adjtimex::
 * ntp_adjtime::
 * ntp_gettime::

+* ntp_gettimex::

 @end menu
 
 @include glibc-functions/adjtimex.texi
 @include glibc-functions/ntp_adjtime.texi
 @include glibc-functions/ntp_gettime.texi
 @end menu
 
 @include glibc-functions/adjtimex.texi
 @include glibc-functions/ntp_adjtime.texi
 @include glibc-functions/ntp_gettime.texi

+@include glibc-functions/ntp_gettimex.texi

 
 @c @node Glibc sys/types.h
 @c @section Glibc Extensions to @code{<sys/types.h>}
 
 @c @node Glibc sys/types.h
 @c @section Glibc Extensions to @code{<sys/types.h>}


@@ -6243,10 +6316,14 @@ This list of functions is sorted according to the header that declares them.
 
 @menu
 * preadv::
 
 @menu
 * preadv::

+* process_vm_readv::
+* process_vm_writev::

 * pwritev::
 @end menu
 
 @include glibc-functions/preadv.texi
 * pwritev::
 @end menu
 
 @include glibc-functions/preadv.texi

+@include glibc-functions/process_vm_readv.texi
+@include glibc-functions/process_vm_writev.texi

 @include glibc-functions/pwritev.texi
 
 @c @node Glibc sys/un.h
 @include glibc-functions/pwritev.texi
 
 @c @node Glibc sys/un.h


@@ -6360,20 +6437,24 @@ This list of functions is sorted according to the header that declares them.
 @section Glibc Extensions to @code{<time.h>}
 
 @menu
 @section Glibc Extensions to @code{<time.h>}
 
 @menu

+* clock_adjtime::

 * dysize::
 * getdate_r::
 * stime::
 * strptime_l::
 * timegm::
 * timelocal::
 * dysize::
 * getdate_r::
 * stime::
 * strptime_l::
 * timegm::
 * timelocal::

+* timespec_get::

 @end menu
 
 @end menu
 

+@include glibc-functions/clock_adjtime.texi

 @include glibc-functions/dysize.texi
 @include glibc-functions/getdate_r.texi
 @include glibc-functions/stime.texi
 @include glibc-functions/strptime_l.texi
 @include glibc-functions/timegm.texi
 @include glibc-functions/timelocal.texi
 @include glibc-functions/dysize.texi
 @include glibc-functions/getdate_r.texi
 @include glibc-functions/stime.texi
 @include glibc-functions/strptime_l.texi
 @include glibc-functions/timegm.texi
 @include glibc-functions/timelocal.texi

+@include glibc-functions/timespec_get.texi

 
 @c @node Glibc trace.h
 @c @section Glibc Extensions to @code{<trace.h>}
 
 @c @node Glibc trace.h
 @c @section Glibc Extensions to @code{<trace.h>}


@@ -6393,6 +6474,9 @@ This list of functions is sorted according to the header that declares them.
 @include glibc-functions/getttynam.texi
 @include glibc-functions/setttyent.texi
 
 @include glibc-functions/getttynam.texi
 @include glibc-functions/setttyent.texi
 

+@c @node Glibc uchar.h
+@c @section Glibc Extensions to @code{<uchar.h>}
+

 @c @node Glibc ucontext.h
 @c @section Glibc Extensions to @code{<ucontext.h>}
 
 @c @node Glibc ucontext.h
 @c @section Glibc Extensions to @code{<ucontext.h>}
 


@@ -6488,6 +6572,7 @@ This list of functions is sorted according to the header that declares them.
 * setutent::
 * updwtmp::
 * utmpname::
 * setutent::
 * updwtmp::
 * utmpname::

+* login::

 * login_tty::
 @end menu
 
 * login_tty::
 @end menu
 


@@ -6502,6 +6587,7 @@ This list of functions is sorted according to the header that declares them.
 @include glibc-functions/setutent.texi
 @include glibc-functions/updwtmp.texi
 @include glibc-functions/utmpname.texi
 @include glibc-functions/setutent.texi
 @include glibc-functions/updwtmp.texi
 @include glibc-functions/utmpname.texi

+@include glibc-functions/login.texi

 @include glibc-functions/login_tty.texi
 
 @node Glibc utmpx.h
 @include glibc-functions/login_tty.texi
 
 @node Glibc utmpx.h