Re: IBM z/OS compatibility issues - per-thread locale functions

[Bruno Haible]

Hi Daniel,

> config.h still has a
> 
>     #define HAVE_DUPLOCALE 1
> 
> line, however. This will be misleading for application code.

Yes, there is a potential for application code to be misled. But
- Any application code can do AC_CHECK_FUNCS_ONCE([duplocale]),
  and this would conflict with gnulib if gnulib was to assign a
  different meaning to HAVE_DUPLOCALE than AC_CHECK_FUNCS gives it.
- We mitigate the problem through documentation.


2019-12-20  Bruno Haible  <address@hidden>

        doc: Document the problem of the per-thread locale functions on z/OS.
        * doc/posix-functions/uselocale.texi: Document the z/OS problem.
        * doc/posix-functions/newlocale.texi: Likewise.
        * doc/posix-functions/duplocale.texi: Likewise.
        * doc/posix-functions/freelocale.texi: Likewise.

diff --git a/doc/posix-functions/duplocale.texi 
b/doc/posix-functions/duplocale.texi
index 4b2ac3e..2fc9841 100644
--- a/doc/posix-functions/duplocale.texi
+++ b/doc/posix-functions/duplocale.texi
@@ -22,4 +22,8 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on many platforms:
 FreeBSD 9.0, NetBSD 5.0, OpenBSD 6.1, Minix 3.1.8, AIX 6.1, HP-UX 11, IRIX 
6.5, Solaris 11.3, Cygwin 2.5.x, mingw, MSVC 14, Android 4.4.
+@item
+This function is useless because the @code{locale_t} type is not defined
+on some platforms:
+z/OS.
 @end itemize
diff --git a/doc/posix-functions/freelocale.texi 
b/doc/posix-functions/freelocale.texi
index 04b9038..a3267dc 100644
--- a/doc/posix-functions/freelocale.texi
+++ b/doc/posix-functions/freelocale.texi
@@ -15,4 +15,8 @@ Portability problems not fixed by Gnulib:
 @item
 This function is missing on many platforms:
 FreeBSD 9.0, NetBSD 5.0, OpenBSD 6.1, Minix 3.1.8, AIX 6.1, HP-UX 11, IRIX 
6.5, Solaris 11.3, Cygwin 2.5.x, mingw, MSVC 14, Android 4.4.
+@item
+This function is useless because the @code{locale_t} type is not defined
+on some platforms:
+z/OS.
 @end itemize
diff --git a/doc/posix-functions/newlocale.texi 
b/doc/posix-functions/newlocale.texi
index 8fc2d4f..f9b623b 100644
--- a/doc/posix-functions/newlocale.texi
+++ b/doc/posix-functions/newlocale.texi
@@ -16,6 +16,10 @@ Portability problems not fixed by Gnulib:
 This function is missing on many platforms:
 FreeBSD 9.0, NetBSD 5.0, OpenBSD 6.1, Minix 3.1.8, AIX 6.1, HP-UX 11, IRIX 
6.5, Solaris 11.3, Cygwin 2.5.x, mingw, MSVC 14, Android 4.4.
 @item
+This function is useless because the @code{locale_t} type is not defined
+on some platforms:
+z/OS.
+@item
 This function is useless because the @code{locale_t} type contains basically
 no information on some platforms:
 OpenBSD 6.3.
diff --git a/doc/posix-functions/uselocale.texi 
b/doc/posix-functions/uselocale.texi
index 809055d..ad11dc7 100644
--- a/doc/posix-functions/uselocale.texi
+++ b/doc/posix-functions/uselocale.texi
@@ -20,6 +20,10 @@ This function is not documented and leads to crashes in 
subsequent
 @code{setlocale} invocations on some platforms:
 AIX 7.2.
 @item
+This function is useless because the @code{locale_t} type is not defined
+on some platforms:
+z/OS.
+@item
 This function is useless because the @code{locale_t} type contains basically
 no information on some platforms:
 OpenBSD 6.3.