]> Savannah Git Hosting - gnulib.git/commitdiff
doc: Update for header files added in POSIX:2024.
authorBruno Haible <bruno@clisp.org>
Thu, 8 Aug 2024 14:46:38 +0000 (16:46 +0200)
committerBruno Haible <bruno@clisp.org>
Thu, 8 Aug 2024 14:46:38 +0000 (16:46 +0200)
* doc/posix-headers/devctl.texi: New file.
* doc/posix-headers/endian.texi: Renamed from
doc/glibc-headers/endian.texi. Update.
* doc/posix-headers/libintl.texi: Renamed from
doc/glibc-headers/libintl.texi. Update.
* doc/gnulib.texi (Header File Substitutes,
Glibc Header File Substitutes): Update.

ChangeLog
doc/glibc-headers/endian.texi [deleted file]
doc/glibc-headers/libintl.texi [deleted file]
doc/gnulib.texi
doc/posix-headers/devctl.texi [new file with mode: 0644]
doc/posix-headers/endian.texi [new file with mode: 0644]
doc/posix-headers/libintl.texi [new file with mode: 0644]

index 738abf32dd22f665ec65f2eb3104b6e37bfe14fe..9416b63c779bf0bfd2cec288c11502d88c19b2f6 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,14 @@
+2024-08-08  Bruno Haible  <bruno@clisp.org>
+
+       doc: Update for header files added in POSIX:2024.
+       * doc/posix-headers/devctl.texi: New file.
+       * doc/posix-headers/endian.texi: Renamed from
+       doc/glibc-headers/endian.texi. Update.
+       * doc/posix-headers/libintl.texi: Renamed from
+       doc/glibc-headers/libintl.texi. Update.
+       * doc/gnulib.texi (Header File Substitutes,
+       Glibc Header File Substitutes): Update.
+
 2024-08-08  Bruno Haible  <bruno@clisp.org>
 
        doc: Update for Cygwin 3.5.3.
diff --git a/doc/glibc-headers/endian.texi b/doc/glibc-headers/endian.texi
deleted file mode 100644 (file)
index fa05b85..0000000
+++ /dev/null
@@ -1,24 +0,0 @@
-@node endian.h
-@section @file{endian.h}
-
-LSB specification:@* @url{https://refspecs.linuxbase.org/LSB_5.0.0/LSB-Core-generic/LSB-Core-generic/libc-ddefs.html}
-
-Specified in POSIX.1-2024.
-Draft specification:@* @url{https://www.austingroupbugs.net/view.php?id=162}
-
-Describes the platform's endianness (byte ordering of words stored in memory).
-Defines the macros @code{BYTE_ORDER}, @code{LITTLE_ENDIAN}, @code{BIG_ENDIAN},
-@code{PDP_ENDIAN}.
-
-Gnulib module: endian
-
-Portability problems fixed by Gnulib:
-@itemize
-@item
-This header file is missing on some platforms:
-macOS 14, FreeBSD 13.0, NetBSD 7.1, OpenBSD 3.8, Minix 3.1.8, AIX 7.3.1, HP-UX 11.31, Solaris 11.4, mingw, MSVC 14.
-@end itemize
-
-Portability problems not fixed by Gnulib:
-@itemize
-@end itemize
diff --git a/doc/glibc-headers/libintl.texi b/doc/glibc-headers/libintl.texi
deleted file mode 100644 (file)
index cca63e5..0000000
+++ /dev/null
@@ -1,43 +0,0 @@
-@node libintl.h
-@section @file{libintl.h}
-
-Defines the macros @code{__USE_GNU_GETTEXT},
-@code{__GNU_GETTEXT_SUPPORTED_REVISION}, and declares the functions
-@code{gettext}, @code{dgettext}, @code{dcgettext},
-@code{ngettext}, @code{dngettext}, @code{dcngettext},
-@code{textdomain}, @code{bindtextdomain}, @code{bind_textdomain_codeset}.
-
-Documentation:
-@itemize
-@item
-@ifinfo
-@ref{Message catalogs with gettext,,The `gettext' family of functions,libc},
-@end ifinfo
-@ifnotinfo
-@url{https://www.gnu.org/software/libc/manual/html_node/Message-catalogs-with-gettext.html},
-@end ifnotinfo
-@item
-@ifinfo
-@ref{gettext,,,gettext},
-@end ifinfo
-@ifnotinfo
-@url{https://www.gnu.org/software/gettext/manual/html_node/gettext.html}.
-@end ifnotinfo
-@end itemize
-
-Gnulib module: gettext
-
-Portability problems fixed by Gnulib, if GNU gettext is installed:
-@itemize
-@item
-This header file is missing on some platforms:
-macOS 14, FreeBSD 14.0, OpenBSD 7.5, Minix 3.1.8, AIX 5.1, HP-UX 11, mingw, MSVC 14, Android 9.0.
-@item
-The functions cannot deal with GNU .mo files with system-dependent strings
-(of major version 1 or of minor version 1) on some non-glibc platforms:
-NetBSD 3.0, Solaris 10.
-@end itemize
-
-Portability problems not fixed by Gnulib:
-@itemize
-@end itemize
index 33e82f2907641fe1ea3a42b8edcabdf3277ab46e..1a4728b9c7bbeb0252461576c578d451e33e45bd 100644 (file)
@@ -1067,8 +1067,10 @@ which (known) portability problems are not worked around by Gnulib.
 * complex.h::
 * cpio.h::
 * ctype.h::
+* devctl.h::
 * dirent.h::
 * dlfcn.h::
+* endian.h::
 * errno.h::
 * fcntl.h::
 * fenv.h::
@@ -1083,6 +1085,7 @@ which (known) portability problems are not worked around by Gnulib.
 * iso646.h::
 * langinfo.h::
 * libgen.h::
+* libintl.h::
 * limits.h::
 * locale.h::
 * math.h::
@@ -1160,8 +1163,10 @@ which (known) portability problems are not worked around by Gnulib.
 @include posix-headers/complex.texi
 @include posix-headers/cpio.texi
 @include posix-headers/ctype.texi
+@include posix-headers/devctl.texi
 @include posix-headers/dirent.texi
 @include posix-headers/dlfcn.texi
+@include posix-headers/endian.texi
 @include posix-headers/errno.texi
 @include posix-headers/fcntl.texi
 @include posix-headers/fenv.texi
@@ -1176,6 +1181,7 @@ which (known) portability problems are not worked around by Gnulib.
 @include posix-headers/iso646.texi
 @include posix-headers/langinfo.texi
 @include posix-headers/libgen.texi
+@include posix-headers/libintl.texi
 @include posix-headers/limits.texi
 @include posix-headers/locale.texi
 @include posix-headers/math.texi
@@ -4843,7 +4849,6 @@ not worked around by Gnulib.
 * argz.h::
 * byteswap.h::
 * crypt.h::
-* endian.h::
 * envz.h::
 * err.h::
 * error.h::
@@ -4855,7 +4860,6 @@ not worked around by Gnulib.
 * gshadow.h::
 * ieee754.h::
 * ifaddrs.h::
-* libintl.h::
 * link.h::
 * malloc.h::
 * mcheck.h::
@@ -4882,7 +4886,6 @@ not worked around by Gnulib.
 @include glibc-headers/argz.texi
 @include glibc-headers/byteswap.texi
 @include glibc-headers/crypt.texi
-@include glibc-headers/endian.texi
 @include glibc-headers/envz.texi
 @include glibc-headers/err.texi
 @include glibc-headers/error.texi
@@ -4894,7 +4897,6 @@ not worked around by Gnulib.
 @include glibc-headers/gshadow.texi
 @include glibc-headers/ieee754.texi
 @include glibc-headers/ifaddrs.texi
-@include glibc-headers/libintl.texi
 @include glibc-headers/link.texi
 @include glibc-headers/malloc.texi
 @include glibc-headers/mcheck.texi
diff --git a/doc/posix-headers/devctl.texi b/doc/posix-headers/devctl.texi
new file mode 100644 (file)
index 0000000..6f8a49a
--- /dev/null
@@ -0,0 +1,17 @@
+@node devctl.h
+@section @file{devctl.h}
+
+POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/devctl.h.html}
+
+Gnulib module: ---
+
+Portability problems fixed by Gnulib:
+@itemize
+@end itemize
+
+Portability problems not fixed by Gnulib:
+@itemize
+@item
+This header file is missing on many platforms:
+glibc 2.40, macOS 14, FreeBSD 9.3, NetBSD 10.0, OpenBSD 7.5, Minix 3.3.0, AIX 7.3.1, HP-UX 11.31, Solaris 11.4, Cygwin 2.6.0, mingw, MSVC 14, Android 9.0.
+@end itemize
diff --git a/doc/posix-headers/endian.texi b/doc/posix-headers/endian.texi
new file mode 100644 (file)
index 0000000..13fbeac
--- /dev/null
@@ -0,0 +1,21 @@
+@node endian.h
+@section @file{endian.h}
+
+POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/endian.h.html}
+
+Describes the platform's endianness (byte ordering of words stored in memory).
+Defines the macros @code{BYTE_ORDER}, @code{LITTLE_ENDIAN}, @code{BIG_ENDIAN},
+@code{PDP_ENDIAN}.
+
+Gnulib module: endian
+
+Portability problems fixed by Gnulib:
+@itemize
+@item
+This header file is missing on some platforms:
+macOS 14, FreeBSD 13.0, NetBSD 7.1, OpenBSD 3.8, Minix 3.1.8, AIX 7.3.1, HP-UX 11.31, Solaris 11.4, mingw, MSVC 14.
+@end itemize
+
+Portability problems not fixed by Gnulib:
+@itemize
+@end itemize
diff --git a/doc/posix-headers/libintl.texi b/doc/posix-headers/libintl.texi
new file mode 100644 (file)
index 0000000..4e6f86d
--- /dev/null
@@ -0,0 +1,45 @@
+@node libintl.h
+@section @file{libintl.h}
+
+POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/libintl.h.html}
+
+Defines the macros @code{__USE_GNU_GETTEXT},
+@code{__GNU_GETTEXT_SUPPORTED_REVISION}, and declares the functions
+@code{gettext}, @code{dgettext}, @code{dcgettext},
+@code{ngettext}, @code{dngettext}, @code{dcngettext},
+@code{textdomain}, @code{bindtextdomain}, @code{bind_textdomain_codeset}.
+
+Documentation:
+@itemize
+@item
+@ifinfo
+@ref{Message catalogs with gettext,,The `gettext' family of functions,libc},
+@end ifinfo
+@ifnotinfo
+@url{https://www.gnu.org/software/libc/manual/html_node/Message-catalogs-with-gettext.html},
+@end ifnotinfo
+@item
+@ifinfo
+@ref{gettext,,,gettext},
+@end ifinfo
+@ifnotinfo
+@url{https://www.gnu.org/software/gettext/manual/html_node/gettext.html}.
+@end ifnotinfo
+@end itemize
+
+Gnulib module: gettext
+
+Portability problems fixed by Gnulib, if GNU gettext is installed:
+@itemize
+@item
+This header file is missing on some platforms:
+macOS 14, FreeBSD 14.0, OpenBSD 7.5, Minix 3.1.8, AIX 5.1, HP-UX 11, mingw, MSVC 14, Android 9.0.
+@item
+The functions cannot deal with GNU .mo files with system-dependent strings
+(of major version 1 or of minor version 1) on some non-glibc platforms:
+NetBSD 3.0, Solaris 10.
+@end itemize
+
+Portability problems not fixed by Gnulib:
+@itemize
+@end itemize