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 <br...@clisp.org>
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
+@include 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
+@include 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
+@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
@@ -3065,6 +3076,8 @@
@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
@@ -3353,6 +3366,7 @@
@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
@@ -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
-@include 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
-@include 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
-@include 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
-@node Glibc uchar.h
-@section Glibc @code{<uchar.h>}
-
-@menu
-* c16rtomb::
-* c32rtomb::
-* mbrtoc16::
-* mbrtoc32::
-@end menu
-
-@include glibc-functions/c16rtomb.texi
-@include glibc-functions/c32rtomb.texi
-@include glibc-functions/mbrtoc16.texi
-@include glibc-functions/mbrtoc32.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>}
