From: Bruno Haible Date: Thu, 8 Aug 2024 14:46:38 +0000 (+0200) Subject: doc: Update for header files added in POSIX:2024. X-Git-Url: https://gitweb.git.savannah.gnu.org/gitweb/?a=commitdiff_plain;h=7499523a88f0b2a3d47b2d9eb6c8193bf0c1cacb;p=gnulib.git 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. --- diff --git a/ChangeLog b/ChangeLog index 738abf32dd..9416b63c77 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,14 @@ +2024-08-08 Bruno Haible + + 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 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 index fa05b85fda..0000000000 --- a/doc/glibc-headers/endian.texi +++ /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 index cca63e526e..0000000000 --- a/doc/glibc-headers/libintl.texi +++ /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 diff --git a/doc/gnulib.texi b/doc/gnulib.texi index 33e82f2907..1a4728b9c7 100644 --- a/doc/gnulib.texi +++ b/doc/gnulib.texi @@ -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 index 0000000000..6f8a49a453 --- /dev/null +++ b/doc/posix-headers/devctl.texi @@ -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 index 0000000000..13fbeacf4e --- /dev/null +++ b/doc/posix-headers/endian.texi @@ -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 index 0000000000..4e6f86d593 --- /dev/null +++ b/doc/posix-headers/libintl.texi @@ -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