Eric Blake wrote: > POSIX 2008 is now freely available at: > ... > http://www.opengroup.org/onlinepubs/9699919799/toc.htm
I'm starting to update the gnulib documentation. Part 1: Handling of functions that were removed. 2008-12-14 Bruno Haible <br...@clisp.org> Update doc for POSIX:2008. * doc/pastposix-functions/bcmp.texi: Renamed from doc/posix-functions/bcmp.texi. * doc/pastposix-functions/bcopy.texi: Renamed from doc/posix-functions/bcopy.texi. * doc/pastposix-functions/bsd_signal.texi: Renamed from doc/posix-functions/bsd_signal.texi. * doc/pastposix-functions/bzero.texi: Renamed from doc/posix-functions/bzero.texi. * doc/pastposix-functions/ecvt.texi: Renamed from doc/posix-functions/ecvt.texi. * doc/pastposix-functions/fcvt.texi: Renamed from doc/posix-functions/fcvt.texi. * doc/pastposix-functions/ftime.texi: Renamed from doc/posix-functions/ftime.texi. * doc/pastposix-functions/gcvt.texi: Renamed from doc/posix-functions/gcvt.texi. * doc/pastposix-functions/getcontext.texi: Renamed from doc/posix-functions/getcontext.texi. * doc/pastposix-functions/gethostbyaddr.texi: Renamed from doc/posix-functions/gethostbyaddr.texi. * doc/pastposix-functions/gethostbyname.texi: Renamed from doc/posix-functions/gethostbyname.texi. * doc/pastposix-functions/getwd.texi: Renamed from doc/posix-functions/getwd.texi. * doc/pastposix-functions/h_errno.texi: Renamed from doc/posix-functions/h_errno.texi. * doc/pastposix-functions/index.texi: Renamed from doc/posix-functions/index.texi. * doc/pastposix-functions/makecontext.texi: Renamed from doc/posix-functions/makecontext.texi. * doc/pastposix-functions/mktemp.texi: Renamed from doc/posix-functions/mktemp.texi. * doc/pastposix-functions/pthread_attr_getstackaddr.texi: Renamed from doc/posix-functions/pthread_attr_getstackaddr.texi. * doc/pastposix-functions/pthread_attr_setstackaddr.texi: Renamed from doc/posix-functions/pthread_attr_setstackaddr.texi. * doc/pastposix-functions/rindex.texi: Renamed from doc/posix-functions/rindex.texi. * doc/pastposix-functions/scalb.texi: Renamed from doc/posix-functions/scalb.texi. * doc/pastposix-functions/setcontext.texi: Renamed from doc/posix-functions/setcontext.texi. * doc/pastposix-functions/swapcontext.texi: Renamed from doc/posix-functions/swapcontext.texi. * doc/pastposix-functions/ualarm.texi: Renamed from doc/posix-functions/ualarm.texi. * doc/pastposix-functions/usleep.texi: Renamed from doc/posix-functions/usleep.texi. * doc/pastposix-functions/vfork.texi: Renamed from doc/posix-functions/vfork.texi. * doc/pastposix-functions/wcswcs.texi: Renamed from doc/posix-functions/wcswcs.texi. * doc/gnulib.texi (Legacy Function Substitutes): New chapter. (Function Substitutes): Update. *** ChangeLog.orig 2008-12-14 14:27:43.000000000 +0100 --- ChangeLog 2008-12-14 14:27:17.000000000 +0100 *************** *** 1,3 **** --- 1,61 ---- + 2008-12-14 Bruno Haible <br...@clisp.org> + + Update doc for POSIX:2008. + * doc/pastposix-functions/bcmp.texi: Renamed from + doc/posix-functions/bcmp.texi. + * doc/pastposix-functions/bcopy.texi: Renamed from + doc/posix-functions/bcopy.texi. + * doc/pastposix-functions/bsd_signal.texi: Renamed from + doc/posix-functions/bsd_signal.texi. + * doc/pastposix-functions/bzero.texi: Renamed from + doc/posix-functions/bzero.texi. + * doc/pastposix-functions/ecvt.texi: Renamed from + doc/posix-functions/ecvt.texi. + * doc/pastposix-functions/fcvt.texi: Renamed from + doc/posix-functions/fcvt.texi. + * doc/pastposix-functions/ftime.texi: Renamed from + doc/posix-functions/ftime.texi. + * doc/pastposix-functions/gcvt.texi: Renamed from + doc/posix-functions/gcvt.texi. + * doc/pastposix-functions/getcontext.texi: Renamed from + doc/posix-functions/getcontext.texi. + * doc/pastposix-functions/gethostbyaddr.texi: Renamed from + doc/posix-functions/gethostbyaddr.texi. + * doc/pastposix-functions/gethostbyname.texi: Renamed from + doc/posix-functions/gethostbyname.texi. + * doc/pastposix-functions/getwd.texi: Renamed from + doc/posix-functions/getwd.texi. + * doc/pastposix-functions/h_errno.texi: Renamed from + doc/posix-functions/h_errno.texi. + * doc/pastposix-functions/index.texi: Renamed from + doc/posix-functions/index.texi. + * doc/pastposix-functions/makecontext.texi: Renamed from + doc/posix-functions/makecontext.texi. + * doc/pastposix-functions/mktemp.texi: Renamed from + doc/posix-functions/mktemp.texi. + * doc/pastposix-functions/pthread_attr_getstackaddr.texi: Renamed from + doc/posix-functions/pthread_attr_getstackaddr.texi. + * doc/pastposix-functions/pthread_attr_setstackaddr.texi: Renamed from + doc/posix-functions/pthread_attr_setstackaddr.texi. + * doc/pastposix-functions/rindex.texi: Renamed from + doc/posix-functions/rindex.texi. + * doc/pastposix-functions/scalb.texi: Renamed from + doc/posix-functions/scalb.texi. + * doc/pastposix-functions/setcontext.texi: Renamed from + doc/posix-functions/setcontext.texi. + * doc/pastposix-functions/swapcontext.texi: Renamed from + doc/posix-functions/swapcontext.texi. + * doc/pastposix-functions/ualarm.texi: Renamed from + doc/posix-functions/ualarm.texi. + * doc/pastposix-functions/usleep.texi: Renamed from + doc/posix-functions/usleep.texi. + * doc/pastposix-functions/vfork.texi: Renamed from + doc/posix-functions/vfork.texi. + * doc/pastposix-functions/wcswcs.texi: Renamed from + doc/posix-functions/wcswcs.texi. + * doc/gnulib.texi (Legacy Function Substitutes): New chapter. + (Function Substitutes): Update. + 2008-12-14 Ralf Wildenhues <ralf.wildenh...@gmx.de> * modules/relocatable-prog-wrapper (Depends-on): Add errno, needed by *** doc/gnulib.texi.orig 2008-12-14 14:27:43.000000000 +0100 --- doc/gnulib.texi 2008-12-14 14:20:55.000000000 +0100 *************** *** 59,64 **** --- 59,65 ---- * POSIX Substitutes Library:: Building as a separate substitutes library. * Header File Substitutes:: Overriding system headers. * Function Substitutes:: Replacing system functions. + * Legacy Function Substitutes:: Replacing system functions. * Glibc Header File Substitutes:: Overriding system headers. * Glibc Function Substitutes:: Replacing system functions. * Particular Modules:: Documentation of individual modules. *************** *** 715,727 **** * atol:: * atoll:: * basename:: - * bcmp:: - * bcopy:: * bind:: - * bsd_signal:: * bsearch:: * btowc:: - * bzero:: * cabs:: * cabsf:: * cabsl:: --- 716,724 ---- *************** *** 851,857 **** * drand48:: * dup:: * dup2:: - * ecvt:: * encrypt:: * endgrent:: * endhostent:: --- 848,853 ---- *************** *** 894,900 **** * fchown:: * fclose:: * fcntl:: - * fcvt:: * fdatasync:: * fdetach:: * fdim:: --- 890,895 ---- *************** *** 965,971 **** * fsync:: * ftell:: * ftello:: - * ftime:: * ftok:: * ftruncate:: * ftrylockfile:: --- 960,965 ---- *************** *** 976,988 **** * fwrite:: * fwscanf:: * gai_strerror:: - * gcvt:: * getaddrinfo:: * getc:: * getc_unlocked:: * getchar:: * getchar_unlocked:: - * getcontext:: * getcwd:: * getdate:: * getdelim:: --- 970,980 ---- *************** *** 996,1003 **** * getgrnam:: * getgrnam_r:: * getgroups:: - * gethostbyaddr:: - * gethostbyname:: * gethostent:: * gethostid:: * gethostname:: --- 988,993 ---- *************** *** 1043,1055 **** * getutxline:: * getwc:: * getwchar:: - * getwd:: * glob:: * globfree:: * gmtime:: * gmtime_r:: * grantpt:: - * h_errno:: * hcreate:: * hdestroy:: * hsearch:: --- 1033,1043 ---- *************** *** 1070,1076 **** * ilogbl:: * imaxabs:: * imaxdiv:: - * index:: * inet_addr:: * inet_ntoa:: * inet_ntop:: --- 1058,1063 ---- *************** *** 1175,1181 **** * lsearch:: * lseek:: * lstat:: - * makecontext:: * malloc:: * mblen:: * mbrlen:: --- 1162,1167 ---- *************** *** 1194,1200 **** * mkfifo:: * mknod:: * mkstemp:: - * mktemp:: * mktime:: * mlock:: * mlockall:: --- 1180,1185 ---- *************** *** 1346,1352 **** * pthread_attr_getschedpolicy:: * pthread_attr_getscope:: * pthread_attr_getstack:: - * pthread_attr_getstackaddr:: * pthread_attr_getstacksize:: * pthread_attr_init:: * pthread_attr_setdetachstate:: --- 1331,1336 ---- *************** *** 1356,1362 **** * pthread_attr_setschedpolicy:: * pthread_attr_setscope:: * pthread_attr_setstack:: - * pthread_attr_setstackaddr:: * pthread_attr_setstacksize:: * pthread_barrier_destroy:: * pthread_barrier_init:: --- 1340,1345 ---- *************** *** 1481,1487 **** * rename:: * rewind:: * rewinddir:: - * rindex:: * rint:: * rintf:: * rintl:: --- 1464,1469 ---- *************** *** 1489,1495 **** * round:: * roundf:: * roundl:: - * scalb:: * scalbln:: * scalblnf:: * scalblnl:: --- 1471,1476 ---- *************** *** 1524,1530 **** * sendmsg:: * sendto:: * setbuf:: - * setcontext:: * setegid:: * setenv:: * seteuid:: --- 1505,1510 ---- *************** *** 1642,1648 **** * strtoumax:: * strxfrm:: * swab:: - * swapcontext:: * swprintf:: * swscanf:: * symlink:: --- 1622,1627 ---- *************** *** 1697,1703 **** * twalk:: * tzname:: * tzset:: - * ualarm:: * ulimit:: * umask:: * uname:: --- 1676,1681 ---- *************** *** 1706,1719 **** * unlink:: * unlockpt:: * unsetenv:: - * usleep:: * utime:: * utimes:: * va_arg:: * va_copy:: * va_end:: * va_start:: - * vfork:: * vfprintf:: * vfscanf:: * vfwprintf:: --- 1684,1695 ---- *************** *** 1758,1764 **** * wcstoul:: * wcstoull:: * wcstoumax:: - * wcswcs:: * wcswidth:: * wcsxfrm:: * wctob:: --- 1734,1739 ---- *************** *** 1835,1847 **** @include posix-functions/atol.texi @include posix-functions/atoll.texi @include posix-functions/basename.texi - @include posix-functions/bcmp.texi - @include posix-functions/bcopy.texi @include posix-functions/bind.texi - @include posix-functions/bsd_signal.texi @include posix-functions/bsearch.texi @include posix-functions/btowc.texi - @include posix-functions/bzero.texi @include posix-functions/cabs.texi @include posix-functions/cabsf.texi @include posix-functions/cabsl.texi --- 1810,1818 ---- *************** *** 1971,1977 **** @include posix-functions/drand48.texi @include posix-functions/dup.texi @include posix-functions/dup2.texi - @include posix-functions/ecvt.texi @include posix-functions/encrypt.texi @include posix-functions/endgrent.texi @include posix-functions/endhostent.texi --- 1942,1947 ---- *************** *** 2014,2020 **** @include posix-functions/fchown.texi @include posix-functions/fclose.texi @include posix-functions/fcntl.texi - @include posix-functions/fcvt.texi @include posix-functions/fdatasync.texi @include posix-functions/fdetach.texi @include posix-functions/fdim.texi --- 1984,1989 ---- *************** *** 2085,2091 **** @include posix-functions/fsync.texi @include posix-functions/ftell.texi @include posix-functions/ftello.texi - @include posix-functions/ftime.texi @include posix-functions/ftok.texi @include posix-functions/ftruncate.texi @include posix-functions/ftrylockfile.texi --- 2054,2059 ---- *************** *** 2096,2108 **** @include posix-functions/fwrite.texi @include posix-functions/fwscanf.texi @include posix-functions/gai_strerror.texi - @include posix-functions/gcvt.texi @include posix-functions/getaddrinfo.texi @include posix-functions/getc.texi @include posix-functions/getc_unlocked.texi @include posix-functions/getchar.texi @include posix-functions/getchar_unlocked.texi - @include posix-functions/getcontext.texi @include posix-functions/getcwd.texi @include posix-functions/getdate.texi @include posix-functions/getdelim.texi --- 2064,2074 ---- *************** *** 2116,2123 **** @include posix-functions/getgrnam.texi @include posix-functions/getgrnam_r.texi @include posix-functions/getgroups.texi - @include posix-functions/gethostbyaddr.texi - @include posix-functions/gethostbyname.texi @include posix-functions/gethostent.texi @include posix-functions/gethostid.texi @include posix-functions/gethostname.texi --- 2082,2087 ---- *************** *** 2163,2175 **** @include posix-functions/getutxline.texi @include posix-functions/getwc.texi @include posix-functions/getwchar.texi - @include posix-functions/getwd.texi @include posix-functions/glob.texi @include posix-functions/globfree.texi @include posix-functions/gmtime.texi @include posix-functions/gmtime_r.texi @include posix-functions/grantpt.texi - @include posix-functions/h_errno.texi @include posix-functions/hcreate.texi @include posix-functions/hdestroy.texi @include posix-functions/hsearch.texi --- 2127,2137 ---- *************** *** 2190,2196 **** @include posix-functions/ilogbl.texi @include posix-functions/imaxabs.texi @include posix-functions/imaxdiv.texi - @include posix-functions/index.texi @include posix-functions/inet_addr.texi @include posix-functions/inet_ntoa.texi @include posix-functions/inet_ntop.texi --- 2152,2157 ---- *************** *** 2295,2301 **** @include posix-functions/lsearch.texi @include posix-functions/lseek.texi @include posix-functions/lstat.texi - @include posix-functions/makecontext.texi @include posix-functions/malloc.texi @include posix-functions/mblen.texi @include posix-functions/mbrlen.texi --- 2256,2261 ---- *************** *** 2314,2320 **** @include posix-functions/mkfifo.texi @include posix-functions/mknod.texi @include posix-functions/mkstemp.texi - @include posix-functions/mktemp.texi @include posix-functions/mktime.texi @include posix-functions/mlock.texi @include posix-functions/mlockall.texi --- 2274,2279 ---- *************** *** 2466,2472 **** @include posix-functions/pthread_attr_getschedpolicy.texi @include posix-functions/pthread_attr_getscope.texi @include posix-functions/pthread_attr_getstack.texi - @include posix-functions/pthread_attr_getstackaddr.texi @include posix-functions/pthread_attr_getstacksize.texi @include posix-functions/pthread_attr_init.texi @include posix-functions/pthread_attr_setdetachstate.texi --- 2425,2430 ---- *************** *** 2476,2482 **** @include posix-functions/pthread_attr_setschedpolicy.texi @include posix-functions/pthread_attr_setscope.texi @include posix-functions/pthread_attr_setstack.texi - @include posix-functions/pthread_attr_setstackaddr.texi @include posix-functions/pthread_attr_setstacksize.texi @include posix-functions/pthread_barrier_destroy.texi @include posix-functions/pthread_barrier_init.texi --- 2434,2439 ---- *************** *** 2601,2607 **** @include posix-functions/rename.texi @include posix-functions/rewind.texi @include posix-functions/rewinddir.texi - @include posix-functions/rindex.texi @include posix-functions/rint.texi @include posix-functions/rintf.texi @include posix-functions/rintl.texi --- 2558,2563 ---- *************** *** 2609,2615 **** @include posix-functions/round.texi @include posix-functions/roundf.texi @include posix-functions/roundl.texi - @include posix-functions/scalb.texi @include posix-functions/scalbln.texi @include posix-functions/scalblnf.texi @include posix-functions/scalblnl.texi --- 2565,2570 ---- *************** *** 2644,2650 **** @include posix-functions/sendmsg.texi @include posix-functions/sendto.texi @include posix-functions/setbuf.texi - @include posix-functions/setcontext.texi @include posix-functions/setegid.texi @include posix-functions/setenv.texi @include posix-functions/seteuid.texi --- 2599,2604 ---- *************** *** 2762,2768 **** @include posix-functions/strtoumax.texi @include posix-functions/strxfrm.texi @include posix-functions/swab.texi - @include posix-functions/swapcontext.texi @include posix-functions/swprintf.texi @include posix-functions/swscanf.texi @include posix-functions/symlink.texi --- 2716,2721 ---- *************** *** 2817,2823 **** @include posix-functions/twalk.texi @include posix-functions/tzname.texi @include posix-functions/tzset.texi - @include posix-functions/ualarm.texi @include posix-functions/ulimit.texi @include posix-functions/umask.texi @include posix-functions/uname.texi --- 2770,2775 ---- *************** *** 2826,2839 **** @include posix-functions/unlink.texi @include posix-functions/unlockpt.texi @include posix-functions/unsetenv.texi - @include posix-functions/usleep.texi @include posix-functions/utime.texi @include posix-functions/utimes.texi @include posix-functions/va_arg.texi @include posix-functions/va_copy.texi @include posix-functions/va_end.texi @include posix-functions/va_start.texi - @include posix-functions/vfork.texi @include posix-functions/vfprintf.texi @include posix-functions/vfscanf.texi @include posix-functions/vfwprintf.texi --- 2778,2789 ---- *************** *** 2878,2884 **** @include posix-functions/wcstoul.texi @include posix-functions/wcstoull.texi @include posix-functions/wcstoumax.texi - @include posix-functions/wcswcs.texi @include posix-functions/wcswidth.texi @include posix-functions/wcsxfrm.texi @include posix-functions/wctob.texi --- 2828,2833 ---- *************** *** 2901,2906 **** --- 2850,2921 ---- @include posix-functions/y1.texi @include posix-functions/yn.texi + @node Legacy Function Substitutes + @chapter Past POSIX Function Substitutes + + This chapter describes which functions and function-like macros specified by + older versions of POSIX (POSIX:2001) are substituted by Gnulib, which + portability pitfalls are fixed by Gnulib, and which (known) portability + problems are not worked around by Gnulib. + + @nosuchmodulenote function + + @menu + * bcmp:: + * bcopy:: + * bsd_signal:: + * bzero:: + * ecvt:: + * fcvt:: + * ftime:: + * gcvt:: + * getcontext:: + * gethostbyaddr:: + * gethostbyname:: + * getwd:: + * h_errno:: + * index:: + * makecontext:: + * mktemp:: + * pthread_attr_getstackaddr:: + * pthread_attr_setstackaddr:: + * rindex:: + * scalb:: + * setcontext:: + * swapcontext:: + * ualarm:: + * usleep:: + * vfork:: + * wcswcs:: + @end menu + + @include pastposix-functions/bcmp.texi + @include pastposix-functions/bcopy.texi + @include pastposix-functions/bsd_signal.texi + @include pastposix-functions/bzero.texi + @include pastposix-functions/ecvt.texi + @include pastposix-functions/fcvt.texi + @include pastposix-functions/ftime.texi + @include pastposix-functions/gcvt.texi + @include pastposix-functions/getcontext.texi + @include pastposix-functions/gethostbyaddr.texi + @include pastposix-functions/gethostbyname.texi + @include pastposix-functions/getwd.texi + @include pastposix-functions/h_errno.texi + @include pastposix-functions/index.texi + @include pastposix-functions/makecontext.texi + @include pastposix-functions/mktemp.texi + @include pastposix-functions/pthread_attr_getstackaddr.texi + @include pastposix-functions/pthread_attr_setstackaddr.texi + @include pastposix-functions/rindex.texi + @include pastposix-functions/scalb.texi + @include pastposix-functions/setcontext.texi + @include pastposix-functions/swapcontext.texi + @include pastposix-functions/ualarm.texi + @include pastposix-functions/usleep.texi + @include pastposix-functions/vfork.texi + @include pastposix-functions/wcswcs.texi + @node Glibc Header File Substitutes @chapter Glibc Header File Substitutes