]> Savannah Git Hosting - gnulib.git/commitdiff
Document POSIX obsolescence
authorPaul Eggert <eggert@cs.ucla.edu>
Wed, 19 Jul 2023 20:51:55 +0000 (13:51 -0700)
committerPaul Eggert <eggert@cs.ucla.edu>
Wed, 19 Jul 2023 20:53:02 +0000 (13:53 -0700)
* doc/posix-functions/_longjmp.texi, doc/posix-functions/_setjmp.texi:
* doc/posix-functions/_tolower.texi, doc/posix-functions/_toupper.texi:
* doc/posix-functions/asctime.texi, doc/posix-functions/asctime_r.texi:
* doc/posix-functions/ctime.texi, doc/posix-functions/ctime_r.texi:
* doc/posix-functions/encrypt.texi, doc/posix-functions/ftw.texi:
* doc/posix-functions/getitimer.texi, doc/posix-functions/gets.texi:
* doc/posix-functions/gettimeofday.texi:
* doc/posix-functions/inet_addr.texi:
* doc/posix-functions/inet_ntoa.texi, doc/posix-functions/isascii.texi:
* doc/posix-functions/pthread_getconcurrency.texi:
* doc/posix-functions/pthread_setconcurrency.texi:
* doc/posix-functions/rand_r.texi, doc/posix-functions/setitimer.texi:
* doc/posix-functions/setkey.texi, doc/posix-functions/setpgrp.texi:
* doc/posix-functions/sighold.texi, doc/posix-functions/sigignore.texi:
* doc/posix-functions/siginterrupt.texi:
* doc/posix-functions/sigpause.texi, doc/posix-functions/sigrelse.texi:
* doc/posix-functions/sigset.texi, doc/posix-functions/tempnam.texi:
* doc/posix-functions/toascii.texi, doc/posix-functions/ulimit.texi:
* doc/posix-functions/utime.texi:
Update as per draft 3 of POSIX 10003.1-202x.

33 files changed:
ChangeLog
doc/posix-functions/_longjmp.texi
doc/posix-functions/_setjmp.texi
doc/posix-functions/_tolower.texi
doc/posix-functions/_toupper.texi
doc/posix-functions/asctime.texi
doc/posix-functions/asctime_r.texi
doc/posix-functions/ctime.texi
doc/posix-functions/ctime_r.texi
doc/posix-functions/encrypt.texi
doc/posix-functions/ftw.texi
doc/posix-functions/getitimer.texi
doc/posix-functions/gets.texi
doc/posix-functions/gettimeofday.texi
doc/posix-functions/inet_addr.texi
doc/posix-functions/inet_ntoa.texi
doc/posix-functions/isascii.texi
doc/posix-functions/pthread_getconcurrency.texi
doc/posix-functions/pthread_setconcurrency.texi
doc/posix-functions/rand_r.texi
doc/posix-functions/setitimer.texi
doc/posix-functions/setkey.texi
doc/posix-functions/setpgrp.texi
doc/posix-functions/sighold.texi
doc/posix-functions/sigignore.texi
doc/posix-functions/siginterrupt.texi
doc/posix-functions/sigpause.texi
doc/posix-functions/sigrelse.texi
doc/posix-functions/sigset.texi
doc/posix-functions/tempnam.texi
doc/posix-functions/toascii.texi
doc/posix-functions/ulimit.texi
doc/posix-functions/utime.texi

index 6a4d92d2188466eaa28f71533ba4ee41d38529bb..ec8cd5261dee3d72ded1b7dc97c97debd5e8fbbc 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,27 @@
+2023-07-19  Paul Eggert  <eggert@cs.ucla.edu>
+
+       Document POSIX obsolescence
+       * doc/posix-functions/_longjmp.texi, doc/posix-functions/_setjmp.texi:
+       * doc/posix-functions/_tolower.texi, doc/posix-functions/_toupper.texi:
+       * doc/posix-functions/asctime.texi, doc/posix-functions/asctime_r.texi:
+       * doc/posix-functions/ctime.texi, doc/posix-functions/ctime_r.texi:
+       * doc/posix-functions/encrypt.texi, doc/posix-functions/ftw.texi:
+       * doc/posix-functions/getitimer.texi, doc/posix-functions/gets.texi:
+       * doc/posix-functions/gettimeofday.texi:
+       * doc/posix-functions/inet_addr.texi:
+       * doc/posix-functions/inet_ntoa.texi, doc/posix-functions/isascii.texi:
+       * doc/posix-functions/pthread_getconcurrency.texi:
+       * doc/posix-functions/pthread_setconcurrency.texi:
+       * doc/posix-functions/rand_r.texi, doc/posix-functions/setitimer.texi:
+       * doc/posix-functions/setkey.texi, doc/posix-functions/setpgrp.texi:
+       * doc/posix-functions/sighold.texi, doc/posix-functions/sigignore.texi:
+       * doc/posix-functions/siginterrupt.texi:
+       * doc/posix-functions/sigpause.texi, doc/posix-functions/sigrelse.texi:
+       * doc/posix-functions/sigset.texi, doc/posix-functions/tempnam.texi:
+       * doc/posix-functions/toascii.texi, doc/posix-functions/ulimit.texi:
+       * doc/posix-functions/utime.texi:
+       Update as per draft 3 of POSIX 10003.1-202x.
+
 2023-07-19  Paul Eggert  <eggert@cs.ucla.edu>
 
        Don’t worry about Version 7 tolower
index dd439c9d5b231fc5529d6ac6b763972b866b12ba..4cbf8f3b325fd0c54a4bde405c2498f1ccf7ca9c 100644 (file)
@@ -15,10 +15,12 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 mingw, MSVC 14.
+@item
+POSIX says this function is obsolescent and it is planned to be
+removed in POSIX 202x.
 @end itemize
 
-Note: A future revision of POSIX later than the 2008/2009 one may drop the
-functions @code{_setjmp} and @code{_longjmp}.  Still, in 2008, on all
+Note: Despite its being removed from POSIX, in 2023 on all
 systems which have @code{_setjmp}, it is the fastest way to save the
 registers but not the signal mask (up to 30 times faster than @code{setjmp}
 on some systems).
index 84e3c4f3f545035828240003daf86f8697447d39..1e6a39907d166f0e4f61ae99ca01c12a860f38a0 100644 (file)
@@ -12,10 +12,12 @@ Portability problems fixed by Gnulib:
 
 Portability problems not fixed by Gnulib:
 @itemize
+@item
+POSIX says this function is obsolescent and it is planned to be
+removed in POSIX 202x.
 @end itemize
 
-Note: A future revision of POSIX later than the 2008/2009 one may drop the
-functions @code{_setjmp} and @code{_longjmp}.  Still, in 2008, on all
+Note: Despite its being removed from POSIX, in 2023 on all
 systems which have @code{_setjmp}, it is the fastest way to save the
 registers but not the signal mask (up to 30 times faster than @code{setjmp}
 on some systems).
index 0d2b6c77572829f273a5fa958acd8423ab2b3872..8446eac3d6e2c54c780e373f213e5e61685c7cba 100644 (file)
@@ -15,4 +15,7 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 macOS 11.1, Minix 3.1.8, Android 4.4.
+@item
+POSIX says this function is obsolescent and it is planned to be
+removed in POSIX 202x.
 @end itemize
index d2025e34b62257f6f86821b92cb26b986f54a6a1..8bcf922a022a22c10d2955985477b0c4d8bc98f7 100644 (file)
@@ -15,4 +15,7 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 macOS 11.1, Minix 3.1.8, Android 4.4.
+@item
+POSIX says this function is obsolescent and it is planned to be
+removed in POSIX 202x.
 @end itemize
index 5c4654a866527707cf90c69cad525a1fecb22650..d1a959d5c13eb03d3fbae1cbb2c531d9ba6e4206 100644 (file)
@@ -16,5 +16,8 @@ Portability problems not fixed by Gnulib:
 This function is deprecated in C23.
 Portable applications can use @code{strftime} (or even @code{sprintf}) instead.
 @item
+POSIX says this function is obsolescent and it is planned to be
+removed in a future version.
+@item
 This function may overflow its internal buffer if an invalid year is passed.
 @end itemize
index 4605b90e72480bbb5a30e928ad5517c4b46b017a..df1b6c9264772180bdf16c44dfcf1b56e72d7a0f 100644 (file)
@@ -21,6 +21,9 @@ Portability problems not fixed by Gnulib:
 This function is missing on some platforms:
 mingw, MSVC 14.
 @item
+POSIX says this function is obsolescent and it is planned to be
+removed in a future version.
+@item
 This function may put more than 26 bytes into the argument buffer if an
 invalid year is passed.
 @end itemize
index 2ac56cb524738a44c8c3078961ebff6fe999b89e..3e8bfcb7033c2629eb8ef1d3822581bc766ed55f 100644 (file)
@@ -20,6 +20,9 @@ This function is deprecated in C23.
 Portable applications can use @code{localtime_r} and @code{strftime}
 (or even @code{sprintf}) instead.
 @item
+POSIX says this function is obsolescent and it is planned to be
+removed in a future version.
+@item
 This function may overflow its internal buffer if an invalid year is passed.
 @item
 The @code{ctime} function need not be reentrant, and consequently is
index 23b9e170052e7cd89683e4e1eb5cbdd49cffdcc4..b9ecc6177ad574b9a1b26e0f0d7ea4e8f52f6983 100644 (file)
@@ -21,6 +21,9 @@ Portability problems not fixed by Gnulib:
 This function is missing on some platforms:
 mingw, MSVC 14.
 @item
+POSIX says this function is obsolescent and it is planned to be
+removed in a future version.
+@item
 This function may put more than 26 bytes into the argument buffer if an
 invalid year is passed.
 @end itemize
index 5e1eb5d0d7fc17685306f634fcacdadd778c982d..5a0aa7439fad903f70927a4774bb39b930e5b9f8 100644 (file)
@@ -19,4 +19,7 @@ NetBSD 5.0, OpenBSD 6.7, Minix 3.1.8, Cygwin 2.9, mingw, MSVC 14, Android 9.0.
 This function is not declared in @code{<unistd.h>}
 (without @code{-D_GNU_SOURCE}) on some platforms:
 glibc (at least 2.11--2.13).
+@item
+POSIX 202x says this function is obsolescent and it is planned to be
+removed in a future version.
 @end itemize
index b880339a9e8b6e10a2535399fe4447fc4b1b2dfa..b6e8581b4c0214ba24b4bb0f52c319b3e7ac712a 100644 (file)
@@ -18,4 +18,7 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 FreeBSD 5.2.1, NetBSD 3.0, Minix 3.1.8, mingw, MSVC 14, Android 4.1.
+@item
+POSIX says this function is obsolescent and it is planned to be
+removed in POSIX 202x.
 @end itemize
index 57e66568eb602df6ae09002ac9510bf81edc63c0..1484366ed3d33c558be2d3c324927d49ffcd2839 100644 (file)
@@ -15,4 +15,7 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 mingw, MSVC 14.
+@item
+POSIX says this function is obsolescent and it is planned to be
+removed in POSIX 202x.
 @end itemize
index 23ba18dc9dff525493b299bd97ed7e56c8cc2247..bb8c90777254bae333ccff7445579d407435505b 100644 (file)
@@ -18,6 +18,9 @@ This function should never be used, because it can overflow any given buffer.
 This function is missing on some platforms:
 OpenBSD 6.7, Solaris 11.4.
 @item
+POSIX says this function is obsolescent and it is planned to be
+removed in POSIX 202x.
+@item
 When reading from a non-blocking pipe whose buffer is empty, this function
 fails with @code{errno} being set to @code{EINVAL} instead of @code{EAGAIN} on
 some platforms:
index a05a448cda87910f40c77c5ceba3e0753bc43629..5a262685bc67fb663d761a090e43476f3b215a65 100644 (file)
@@ -33,4 +33,7 @@ Portability problems not fixed by Gnulib:
 @item
 Behavior is non-portable if the second argument to @code{gettimeofday}
 is not @code{NULL}.
+@item
+POSIX says this function is obsolescent and it is planned to be
+removed in POSIX 202x.
 @end itemize
index d1de9adf27439ce656748ce86ad91ccbb8b6876d..cfe9f9b254da3b8d8dd4023316beb10c02e3c361 100644 (file)
@@ -16,6 +16,9 @@ Portability problems not fixed by Gnulib:
 This function is missing on some platforms:
 mingw, MSVC 14.
 @item
+POSIX 202x says this function is obsolescent and it is planned to be
+removed in a future version.
+@item
 On some old platforms, this function returns a @samp{struct in_addr} rather
 than a scalar type such as @samp{unsigned int} or @samp{unsigned long}.
 @end itemize
index 1bd7ef5d1add9b59b9ffc70a8cd635d6a3c032cb..afe029ec28bf9a686ed931c06ef926a93610942c 100644 (file)
@@ -16,6 +16,9 @@ Portability problems not fixed by Gnulib:
 This function is missing on some platforms:
 mingw, MSVC 14.
 @item
+POSIX 202x says this function is obsolescent and it is planned to be
+removed in a future version.
+@item
 The @code{inet_ntoa} function need not be reentrant, and consequently
 is not required to be thread safe.  Implementations of
 @code{inet_ntoa} typically write the timestamp into static buffer.
index e9f58624a010d120d41bdd293e7c782f104de677..b46571d26e0c5a034f3a227c6916d689640be656 100644 (file)
@@ -16,6 +16,9 @@ OS X 10.8.
 
 Portability problems not fixed by Gnulib:
 @itemize
+@item
+POSIX says this function is obsolescent and it is planned to be
+removed in POSIX 202x.
 @end itemize
 
 Note: This function's behaviour depends on the locale, but requires special
index 3aef4113f5ec272e342e5f2205759019f232559f..74210f552ec60b9fdaa391f985952c036b3ea5a1 100644 (file)
@@ -15,4 +15,7 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 NetBSD 9.0, Minix 3.1.8, mingw, MSVC 14, Android 9.0.
+@item
+POSIX says this function is obsolescent and it is planned to be
+removed in POSIX 202x.
 @end itemize
index cb885c828a80a9364af29f466262393afb39385f..e1205ff394686b323d4526e6652e398b2a4c3bbb 100644 (file)
@@ -15,4 +15,7 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 NetBSD 9.0, Minix 3.1.8, mingw, MSVC 14, Android 9.0.
+@item
+POSIX says this function is obsolescent and it is planned to be
+removed in POSIX 202x.
 @end itemize
index eedb8fb71bcbfc870850f525f648a1a9637669a3..669b6804595ba5ec2a8bf646e10247b02122c9d5 100644 (file)
@@ -15,4 +15,7 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 Minix 3.1.8, mingw, MSVC 14, Android 4.4.
+@item
+POSIX says this function is obsolescent and it is planned to be
+removed in POSIX 202x.
 @end itemize
index 939e6cc97deae8536dde56900633d8336c4e960a..cba471bd5422d29bcf90beb2683feec231b124a5 100644 (file)
@@ -15,4 +15,7 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 mingw, MSVC 14.
+@item
+POSIX says this function is obsolescent and it is planned to be
+removed in POSIX 202x.
 @end itemize
index 9f52aa0cc68216b360bfa034ae858c37e089a647..794e60f3d87c57809e9ab7bdd45e6dc47654b22b 100644 (file)
@@ -19,4 +19,7 @@ glibc 2.34, NetBSD 5.0, OpenBSD 6.7, Minix 3.1.8, Cygwin 2.9, mingw, MSVC 14, An
 This function is not declared in @code{<stdlib.h>}
 (without @code{-D_GNU_SOURCE}) on some platforms:
 glibc (at least 2.11--2.13).
+@item
+POSIX 202x says this function is obsolescent and it is planned to be
+removed in a future version.
 @end itemize
index 46bfb7843715295b1e727fa120ad055a2bb84bc3..1a7e22df6d397d7764c6c0058bd0e6f9660b3ea6 100644 (file)
@@ -15,4 +15,7 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 Minix 3.1.8, mingw, MSVC 14.
+@item
+POSIX says this function is obsolescent and it is planned to be
+removed in POSIX 202x.
 @end itemize
index 66a0cf346d1965547f6f08d1fe7d72ea8dcd3ad4..3a926fbacb563a2d7e69bbff399b296b63eba9c4 100644 (file)
@@ -15,4 +15,7 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 FreeBSD 6.0, OpenBSD 6.7, Minix 3.1.8, mingw, MSVC 14, Android 7.1.
+@item
+POSIX says this function is obsolescent and it is planned to be
+removed in POSIX 202x.
 @end itemize
index 5b0879dfff5f88828040366322075fd358367472..1e8ef235bff449181c56458dbf313d86bb89f6ef 100644 (file)
@@ -15,4 +15,7 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 FreeBSD 6.0, OpenBSD 6.7, Minix 3.1.8, Cygwin 1.5.x, mingw, MSVC 14, Android 7.1.
+@item
+POSIX says this function is obsolescent and it is planned to be
+removed in POSIX 202x.
 @end itemize
index a86fe5e8750e698751e3a0cf32bd04fd566b003d..36c82be8c49982e468c771516ddbd40ce3b23902 100644 (file)
@@ -15,6 +15,9 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 Minix 3.1.8, mingw, MSVC 14.
+@item
+POSIX says this function is obsolescent and it is planned to be
+removed in POSIX 202x.
 @end itemize
 
 Note: POSIX recommends using @code{sigaction} with SA_RESTART instead of
index 46ff40be5e6cceaa5cd2f1eb44ca9cf6b0e79302..71377e63c8e75f9f83087c2b667504c463fa0c95 100644 (file)
@@ -17,4 +17,7 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 Minix 3.1.8, mingw, MSVC 14, Android 7.1.
+@item
+POSIX says this function is obsolescent and it is planned to be
+removed in POSIX 202x.
 @end itemize
index f32e4e1b252ddaf5ae43a3efb6374b88cb41aa59..42f4665dc987f1153e8489baa1a8fb0a1a0bcfcc 100644 (file)
@@ -15,4 +15,7 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 FreeBSD 6.0, OpenBSD 6.7, Minix 3.1.8, mingw, MSVC 14, Android 7.1.
+@item
+POSIX says this function is obsolescent and it is planned to be
+removed in POSIX 202x.
 @end itemize
index e269786d5018dc38c4df6604fc7209d0edfa8b4d..dba7838511066e65db77613d34d64a0bf4fa15d2 100644 (file)
@@ -15,4 +15,7 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 FreeBSD 6.0, OpenBSD 6.7, Minix 3.1.8, Cygwin 1.5.x, mingw, MSVC 14, Android 7.1.
+@item
+POSIX says this function is obsolescent and it is planned to be
+removed in POSIX 202x.
 @end itemize
index c4b767793e3f1363fd7367b50612f5003ea27f00..e68b8d688ce7f8148661cbdac8c29bc9e63d9427 100644 (file)
@@ -16,6 +16,9 @@ Portability problems not fixed by Gnulib:
 This function is missing on some platforms:
 Minix 3.1.8.
 @item
+POSIX says this function is obsolescent and it is planned to be
+removed in POSIX 202x.
+@item
 This function is not appropriate for creating temporary files.  (It has
 security risks.)  Better use @code{mkstemp} instead.
 @end itemize
index 9f5a3d3e4047c1994498167c30c5e9824ff36c45..396ea45221fa35bf8511d39558a8e61ce3c6ed49 100644 (file)
@@ -16,4 +16,7 @@ OS X 10.8.
 
 Portability problems not fixed by Gnulib:
 @itemize
+@item
+POSIX says this function is obsolescent and it is planned to be
+removed in POSIX 202x.
 @end itemize
index 1b688efef499d7c2b8e189abea07d8390ae1f292..e12808b9e3095dea35d909f0121a3dab45a55b01 100644 (file)
@@ -15,4 +15,7 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on some platforms:
 OpenBSD 6.7, Minix 3.1.8, Cygwin 2.9, mingw, MSVC 14, Android 9.0.
+@item
+POSIX says this function is obsolescent and it is planned to be
+removed in POSIX 202x.
 @end itemize
index 32fbf369a55e60290e41c5626e3203582bd275dd..4c0bc7f3ed8d029714e95479ea8bfdb0a3f65765 100644 (file)
@@ -31,4 +31,7 @@ Solaris 9.
 This function cannot set full timestamp resolution.  Use
 @code{utimensat(AT_FDCWD,file,times,0)}, or the gnulib module @code{utimens},
 instead.
+@item
+POSIX says this function is obsolescent and it is planned to be
+removed in POSIX 202x.
 @end itemize