Re: docs: update glibc progress

[Bruno Haible]

Eric Blake wrote:
> while the current POSIX 2008 (Issue 7) only
> requires C99, the next POSIX 1x (Issue 8) will likely require C11.  So I
> think uchar.texi belongs under posix-headers, or else we create a new
> intermediate directory for c11-headers and c11-functions.

I don't think POSIX will diverge from ISO C11. Therefore the intermediate
directory could also be called 'future-posix-headers'. But we already have
taken the habit to classify future POSIX functions under 'posix-functions'.
So let me just move these things under 'posix-headers' and 'posix-functions'.

> >     * doc/glibc-headers/uchar.texi: New file.
> 
> <uchar.h> is C11.  We stuck 'stdnoreturn.texi' under posix-headers,
> under the argument that 
> 
> >     * doc/glibc-functions/aligned_alloc.texi: New file.
> 
> Likewise, aligned_alloc is another C11 function.

Good point, thanks. Fixed as follows:


2012-02-28  Bruno Haible  <address@hidden>

        doc: Move ISO C11 feature notes into POSIX chapters.
        * doc/posix-functions/aligned_alloc.texi: Renamed from
        glibc-functions/aligned_alloc.texi.
        * doc/posix-functions/quick_exit.texi: Renamed from
        glibc-functions/quick_exit.texi.
        * doc/posix-headers/uchar.texi: Renamed from glibc-headers/uchar.texi.
        * doc/posix-functions/c16rtomb.texi: Renamed from
        glibc-functions/c16rtomb.texi.
        * doc/posix-functions/c32rtomb.texi: Renamed from
        glibc-functions/c32rtomb.texi.
        * doc/posix-functions/mbrtoc16.texi: Renamed from
        glibc-functions/mbrtoc16.texi.
        * doc/posix-functions/mbrtoc32.texi: Renamed from
        glibc-functions/mbrtoc32.texi.
        * doc/gnulib.texi: Update.
        (Glibc uchar.h): Remove section.
        Suggested by Eric Blake.

--- doc/gnulib.texi.orig        Tue Feb 28 19:16:05 2012
+++ doc/gnulib.texi     Tue Feb 28 19:16:02 2012
@@ -1222,6 +1222,7 @@
 * tgmath.h::
 * time.h::
 * trace.h::
+* uchar.h::
 * ucontext.h::
 * ulimit.h::
 * unistd.h::
@@ -1310,6 +1311,7 @@
 @include posix-headers/tgmath.texi
 @include posix-headers/time.texi
 @include posix-headers/trace.texi
address@hidden posix-headers/uchar.texi
 @include posix-headers/ucontext.texi
 @include posix-headers/ulimit.texi
 @include posix-headers/unistd.texi
@@ -1359,6 +1361,7 @@
 * aio_suspend::
 * aio_write::
 * alarm::
+* aligned_alloc::
 * alphasort::
 * asctime::
 * asctime_r::
@@ -1387,6 +1390,8 @@
 * bind::
 * bsearch::
 * btowc::
+* c16rtomb::
+* c32rtomb::
 * cabs::
 * cabsf::
 * cabsl::
@@ -1872,6 +1877,8 @@
 * malloc::
 * mblen::
 * mbrlen::
+* mbrtoc16::
+* mbrtoc32::
 * mbrtowc::
 * mbsinit::
 * mbsnrtowcs::
@@ -2160,6 +2167,7 @@
 * putwchar::
 * pwrite::
 * qsort::
+* quick_exit::
 * raise::
 * rand::
 * rand_r::
@@ -2552,6 +2560,7 @@
 @include posix-functions/aio_suspend.texi
 @include posix-functions/aio_write.texi
 @include posix-functions/alarm.texi
address@hidden posix-functions/aligned_alloc.texi
 @include posix-functions/alphasort.texi
 @include posix-functions/asctime.texi
 @include posix-functions/asctime_r.texi
@@ -2580,6 +2589,8 @@
 @include posix-functions/bind.texi
 @include posix-functions/bsearch.texi
 @include posix-functions/btowc.texi
address@hidden posix-functions/c16rtomb.texi
address@hidden posix-functions/c32rtomb.texi
 @include posix-functions/cabs.texi
 @include posix-functions/cabsf.texi
 @include posix-functions/cabsl.texi
@@ -3065,6 +3076,8 @@
 @include posix-functions/malloc.texi
 @include posix-functions/mblen.texi
 @include posix-functions/mbrlen.texi
address@hidden posix-functions/mbrtoc16.texi
address@hidden posix-functions/mbrtoc32.texi
 @include posix-functions/mbrtowc.texi
 @include posix-functions/mbsinit.texi
 @include posix-functions/mbsnrtowcs.texi
@@ -3353,6 +3366,7 @@
 @include posix-functions/putwchar.texi
 @include posix-functions/pwrite.texi
 @include posix-functions/qsort.texi
address@hidden posix-functions/quick_exit.texi
 @include posix-functions/raise.texi
 @include posix-functions/rand.texi
 @include posix-functions/rand_r.texi
@@ -3824,7 +3838,6 @@
 * sys/ioctl.h::
 * sysexits.h::
 * ttyent.h::
-* uchar.h::
 @end menu
 
 @include glibc-headers/a.out.texi
@@ -3859,7 +3872,6 @@
 @include glibc-headers/sys_ioctl.texi
 @include glibc-headers/sysexits.texi
 @include glibc-headers/ttyent.texi
address@hidden glibc-headers/uchar.texi
 
 @node Glibc Function Substitutes
 @chapter Glibc Function Substitutes
@@ -3985,7 +3997,6 @@
 * Glibc termios.h::
 * Glibc time.h::
 * Glibc ttyent.h::
-* Glibc uchar.h::
 * Glibc unistd.h::
 * Glibc utmp.h::
 * Glibc utmpx.h::
@@ -5821,7 +5832,6 @@
 @section Glibc Extensions to @code{<stdlib.h>}
 
 @menu
-* aligned_alloc::
 * canonicalize_file_name::
 * cfree::
 * clearenv::
@@ -5848,7 +5858,6 @@
 * qfcvt_r::
 * qgcvt::
 * qsort_r::
-* quick_exit::
 * random_r::
 * rpmatch::
 * seed48_r::
@@ -5867,7 +5876,6 @@
 * valloc::
 @end menu
 
address@hidden glibc-functions/aligned_alloc.texi
 @include glibc-functions/canonicalize_file_name.texi
 @include glibc-functions/cfree.texi
 @include glibc-functions/clearenv.texi
@@ -5894,7 +5902,6 @@
 @include glibc-functions/qfcvt_r.texi
 @include glibc-functions/qgcvt.texi
 @include glibc-functions/qsort_r.texi
address@hidden glibc-functions/quick_exit.texi
 @include glibc-functions/random_r.texi
 @include glibc-functions/rpmatch.texi
 @include glibc-functions/seed48_r.texi
@@ -6467,20 +6474,8 @@
 @include glibc-functions/getttynam.texi
 @include glibc-functions/setttyent.texi
 
address@hidden Glibc uchar.h
address@hidden Glibc @code{<uchar.h>}
-
address@hidden
-* c16rtomb::
-* c32rtomb::
-* mbrtoc16::
-* mbrtoc32::
address@hidden menu
-
address@hidden glibc-functions/c16rtomb.texi
address@hidden glibc-functions/c32rtomb.texi
address@hidden glibc-functions/mbrtoc16.texi
address@hidden glibc-functions/mbrtoc32.texi
address@hidden @node Glibc uchar.h
address@hidden @section Glibc Extensions to @code{<uchar.h>}
 
 @c @node Glibc ucontext.h
 @c @section Glibc Extensions to @code{<ucontext.h>}