18 files changed, 152 insertions, 18 deletions
diff --git a/doc/posix-functions/isalnum.texi b/doc/posix-functions/isalnum.texi
index b538d199c1..422b55d193 100644
--- a/doc/posix-functions/isalnum.texi
+++ b/doc/posix-functions/isalnum.texi
@@ -21,7 +21,7 @@ Portability problems not fixed by Gnulib:
 Note: This function's behaviour depends on the locale, but does not support
 the multibyte characters that occur in strings in locales with
 @code{MB_CUR_MAX > 1} (this includes all the common UTF-8 locales).
-There are four alternative APIs:
+There are five alternative APIs:
 
 @table @code
 @item c_isalnum
@@ -34,6 +34,12 @@ order to use it, you first have to convert from multibyte to wide characters,
 using the @code{mbrtowc} function.  It is provided by the Gnulib module
 @samp{wctype}.
 
+@item c32isalnum
+This function operates in a locale dependent way, on 32-bit wide characters.
+In order to use it, you first have to convert from multibyte to 32-bit wide
+characters, using the @code{mbrtoc32} function.  It is provided by the
+Gnulib module @samp{c32isalnum}.
+
 @item mb_isalnum
 This function operates in a locale dependent way, on multibyte characters.
 It is provided by the Gnulib module @samp{mbchar}.
diff --git a/doc/posix-functions/isalpha.texi b/doc/posix-functions/isalpha.texi
index 2e4304ea8b..ee1c644a42 100644
--- a/doc/posix-functions/isalpha.texi
+++ b/doc/posix-functions/isalpha.texi
@@ -21,7 +21,7 @@ Portability problems not fixed by Gnulib:
 Note: This function's behaviour depends on the locale, but does not support
 the multibyte characters that occur in strings in locales with
 @code{MB_CUR_MAX > 1} (this includes all the common UTF-8 locales).
-There are four alternative APIs:
+There are five alternative APIs:
 
 @table @code
 @item c_isalpha
@@ -34,6 +34,12 @@ order to use it, you first have to convert from multibyte to wide characters,
 using the @code{mbrtowc} function.  It is provided by the Gnulib module
 @samp{wctype}.
 
+@item c32isalpha
+This function operates in a locale dependent way, on 32-bit wide characters.
+In order to use it, you first have to convert from multibyte to 32-bit wide
+characters, using the @code{mbrtoc32} function.  It is provided by the
+Gnulib module @samp{c32isalpha}.
+
 @item mb_isalpha
 This function operates in a locale dependent way, on multibyte characters.
 It is provided by the Gnulib module @samp{mbchar}.
diff --git a/doc/posix-functions/isblank.texi b/doc/posix-functions/isblank.texi
index ab23391ac6..18b09fd903 100644
--- a/doc/posix-functions/isblank.texi
+++ b/doc/posix-functions/isblank.texi
@@ -24,7 +24,7 @@ Portability problems not fixed by Gnulib:
 Note: This function's behaviour depends on the locale, but does not support
 the multibyte characters that occur in strings in locales with
 @code{MB_CUR_MAX > 1} (this includes all the common UTF-8 locales).
-There are four alternative APIs:
+There are five alternative APIs:
 
 @table @code
 @item c_isblank
@@ -37,6 +37,12 @@ order to use it, you first have to convert from multibyte to wide characters,
 using the @code{mbrtowc} function.  It is provided by the Gnulib module
 @samp{wctype}.
 
+@item c32isblank
+This function operates in a locale dependent way, on 32-bit wide characters.
+In order to use it, you first have to convert from multibyte to 32-bit wide
+characters, using the @code{mbrtoc32} function.  It is provided by the
+Gnulib module @samp{c32isblank}.
+
 @item mb_isblank
 This function operates in a locale dependent way, on multibyte characters.
 It is provided by the Gnulib module @samp{mbchar}.
diff --git a/doc/posix-functions/iscntrl.texi b/doc/posix-functions/iscntrl.texi
index 19758ef1da..c6a40314f6 100644
--- a/doc/posix-functions/iscntrl.texi
+++ b/doc/posix-functions/iscntrl.texi
@@ -21,7 +21,7 @@ Portability problems not fixed by Gnulib:
 Note: This function's behaviour depends on the locale, but does not support
 the multibyte characters that occur in strings in locales with
 @code{MB_CUR_MAX > 1} (this includes all the common UTF-8 locales).
-There are four alternative APIs:
+There are five alternative APIs:
 
 @table @code
 @item c_iscntrl
@@ -34,6 +34,12 @@ order to use it, you first have to convert from multibyte to wide characters,
 using the @code{mbrtowc} function.  It is provided by the Gnulib module
 @samp{wctype}.
 
+@item c32iscntrl
+This function operates in a locale dependent way, on 32-bit wide characters.
+In order to use it, you first have to convert from multibyte to 32-bit wide
+characters, using the @code{mbrtoc32} function.  It is provided by the
+Gnulib module @samp{c32iscntrl}.
+
 @item mb_iscntrl
 This function operates in a locale dependent way, on multibyte characters.
 It is provided by the Gnulib module @samp{mbchar}.
diff --git a/doc/posix-functions/isdigit.texi b/doc/posix-functions/isdigit.texi
index 2494170827..7d01a500b2 100644
--- a/doc/posix-functions/isdigit.texi
+++ b/doc/posix-functions/isdigit.texi
@@ -21,7 +21,7 @@ Portability problems not fixed by Gnulib:
 Note: This function's behaviour depends on the locale, but does not support
 the multibyte characters that occur in strings in locales with
 @code{MB_CUR_MAX > 1} (this includes all the common UTF-8 locales).
-There are four alternative APIs:
+There are five alternative APIs:
 
 @table @code
 @item c_isdigit
@@ -34,6 +34,12 @@ order to use it, you first have to convert from multibyte to wide characters,
 using the @code{mbrtowc} function.  It is provided by the Gnulib module
 @samp{wctype}.
 
+@item c32isdigit
+This function operates in a locale dependent way, on 32-bit wide characters.
+In order to use it, you first have to convert from multibyte to 32-bit wide
+characters, using the @code{mbrtoc32} function.  It is provided by the
+Gnulib module @samp{c32isdigit}.
+
 @item mb_isdigit
 This function operates in a locale dependent way, on multibyte characters.
 It is provided by the Gnulib module @samp{mbchar}.
diff --git a/doc/posix-functions/isgraph.texi b/doc/posix-functions/isgraph.texi
index 01fbc83cb7..a4754dda3b 100644
--- a/doc/posix-functions/isgraph.texi
+++ b/doc/posix-functions/isgraph.texi
@@ -21,7 +21,7 @@ Portability problems not fixed by Gnulib:
 Note: This function's behaviour depends on the locale, but does not support
 the multibyte characters that occur in strings in locales with
 @code{MB_CUR_MAX > 1} (this includes all the common UTF-8 locales).
-There are four alternative APIs:
+There are five alternative APIs:
 
 @table @code
 @item c_isgraph
@@ -34,6 +34,12 @@ order to use it, you first have to convert from multibyte to wide characters,
 using the @code{mbrtowc} function.  It is provided by the Gnulib module
 @samp{wctype}.
 
+@item c32isgraph
+This function operates in a locale dependent way, on 32-bit wide characters.
+In order to use it, you first have to convert from multibyte to 32-bit wide
+characters, using the @code{mbrtoc32} function.  It is provided by the
+Gnulib module @samp{c32isgraph}.
+
 @item mb_isgraph
 This function operates in a locale dependent way, on multibyte characters.
 It is provided by the Gnulib module @samp{mbchar}.
diff --git a/doc/posix-functions/islower.texi b/doc/posix-functions/islower.texi
index 8eba57ae5a..fb3a898ab7 100644
--- a/doc/posix-functions/islower.texi
+++ b/doc/posix-functions/islower.texi
@@ -21,7 +21,7 @@ Portability problems not fixed by Gnulib:
 Note: This function's behaviour depends on the locale, but does not support
 the multibyte characters that occur in strings in locales with
 @code{MB_CUR_MAX > 1} (this includes all the common UTF-8 locales).
-There are four alternative APIs:
+There are five alternative APIs:
 
 @table @code
 @item c_islower
@@ -34,6 +34,12 @@ order to use it, you first have to convert from multibyte to wide characters,
 using the @code{mbrtowc} function.  It is provided by the Gnulib module
 @samp{wctype}.
 
+@item c32islower
+This function operates in a locale dependent way, on 32-bit wide characters.
+In order to use it, you first have to convert from multibyte to 32-bit wide
+characters, using the @code{mbrtoc32} function.  It is provided by the
+Gnulib module @samp{c32islower}.
+
 @item mb_islower
 This function operates in a locale dependent way, on multibyte characters.
 It is provided by the Gnulib module @samp{mbchar}.
diff --git a/doc/posix-functions/isprint.texi b/doc/posix-functions/isprint.texi
index e30ddc958d..931776f34c 100644
--- a/doc/posix-functions/isprint.texi
+++ b/doc/posix-functions/isprint.texi
@@ -21,7 +21,7 @@ Portability problems not fixed by Gnulib:
 Note: This function's behaviour depends on the locale, but does not support
 the multibyte characters that occur in strings in locales with
 @code{MB_CUR_MAX > 1} (this includes all the common UTF-8 locales).
-There are four alternative APIs:
+There are five alternative APIs:
 
 @table @code
 @item c_isprint
@@ -34,6 +34,12 @@ order to use it, you first have to convert from multibyte to wide characters,
 using the @code{mbrtowc} function.  It is provided by the Gnulib module
 @samp{wctype}.
 
+@item c32isprint
+This function operates in a locale dependent way, on 32-bit wide characters.
+In order to use it, you first have to convert from multibyte to 32-bit wide
+characters, using the @code{mbrtoc32} function.  It is provided by the
+Gnulib module @samp{c32isprint}.
+
 @item mb_isprint
 This function operates in a locale dependent way, on multibyte characters.
 It is provided by the Gnulib module @samp{mbchar}.
diff --git a/doc/posix-functions/ispunct.texi b/doc/posix-functions/ispunct.texi
index 2f245202a2..252b5773f5 100644
--- a/doc/posix-functions/ispunct.texi
+++ b/doc/posix-functions/ispunct.texi
@@ -21,7 +21,7 @@ Portability problems not fixed by Gnulib:
 Note: This function's behaviour depends on the locale, but does not support
 the multibyte characters that occur in strings in locales with
 @code{MB_CUR_MAX > 1} (this includes all the common UTF-8 locales).
-There are four alternative APIs:
+There are five alternative APIs:
 
 @table @code
 @item c_ispunct
@@ -34,6 +34,12 @@ order to use it, you first have to convert from multibyte to wide characters,
 using the @code{mbrtowc} function.  It is provided by the Gnulib module
 @samp{wctype}.
 
+@item c32ispunct
+This function operates in a locale dependent way, on 32-bit wide characters.
+In order to use it, you first have to convert from multibyte to 32-bit wide
+characters, using the @code{mbrtoc32} function.  It is provided by the
+Gnulib module @samp{c32ispunct}.
+
 @item mb_ispunct
 This function operates in a locale dependent way, on multibyte characters.
 It is provided by the Gnulib module @samp{mbchar}.
diff --git a/doc/posix-functions/isspace.texi b/doc/posix-functions/isspace.texi
index c0817ca768..ab7b0b41d8 100644
--- a/doc/posix-functions/isspace.texi
+++ b/doc/posix-functions/isspace.texi
@@ -21,7 +21,7 @@ Portability problems not fixed by Gnulib:
 Note: This function's behaviour depends on the locale, but does not support
 the multibyte characters that occur in strings in locales with
 @code{MB_CUR_MAX > 1} (this includes all the common UTF-8 locales).
-There are four alternative APIs:
+There are five alternative APIs:
 
 @table @code
 @item c_isspace
@@ -34,6 +34,12 @@ order to use it, you first have to convert from multibyte to wide characters,
 using the @code{mbrtowc} function.  It is provided by the Gnulib module
 @samp{wctype}.
 
+@item c32isspace
+This function operates in a locale dependent way, on 32-bit wide characters.
+In order to use it, you first have to convert from multibyte to 32-bit wide
+characters, using the @code{mbrtoc32} function.  It is provided by the
+Gnulib module @samp{c32isspace}.
+
 @item mb_isspace
 This function operates in a locale dependent way, on multibyte characters.
 It is provided by the Gnulib module @samp{mbchar}.
diff --git a/doc/posix-functions/isupper.texi b/doc/posix-functions/isupper.texi
index 295e86cf4d..eb2b0ff0b6 100644
--- a/doc/posix-functions/isupper.texi
+++ b/doc/posix-functions/isupper.texi
@@ -21,7 +21,7 @@ Portability problems not fixed by Gnulib:
 Note: This function's behaviour depends on the locale, but does not support
 the multibyte characters that occur in strings in locales with
 @code{MB_CUR_MAX > 1} (this includes all the common UTF-8 locales).
-There are four alternative APIs:
+There are five alternative APIs:
 
 @table @code
 @item c_isupper
@@ -34,6 +34,12 @@ order to use it, you first have to convert from multibyte to wide characters,
 using the @code{mbrtowc} function.  It is provided by the Gnulib module
 @samp{wctype}.
 
+@item c32isupper
+This function operates in a locale dependent way, on 32-bit wide characters.
+In order to use it, you first have to convert from multibyte to 32-bit wide
+characters, using the @code{mbrtoc32} function.  It is provided by the
+Gnulib module @samp{c32isupper}.
+
 @item mb_isupper
 This function operates in a locale dependent way, on multibyte characters.
 It is provided by the Gnulib module @samp{mbchar}.
diff --git a/doc/posix-functions/isxdigit.texi b/doc/posix-functions/isxdigit.texi
index e5b78bceaa..5e13b008c4 100644
--- a/doc/posix-functions/isxdigit.texi
+++ b/doc/posix-functions/isxdigit.texi
@@ -21,7 +21,7 @@ Portability problems not fixed by Gnulib:
 Note: This function's behaviour depends on the locale, but does not support
 the multibyte characters that occur in strings in locales with
 @code{MB_CUR_MAX > 1} (this includes all the common UTF-8 locales).
-There are four alternative APIs:
+There are five alternative APIs:
 
 @table @code
 @item c_isxdigit
@@ -34,6 +34,12 @@ order to use it, you first have to convert from multibyte to wide characters,
 using the @code{mbrtowc} function.  It is provided by the Gnulib module
 @samp{wctype}.
 
+@item c32isxdigit
+This function operates in a locale dependent way, on 32-bit wide characters.
+In order to use it, you first have to convert from multibyte to 32-bit wide
+characters, using the @code{mbrtoc32} function.  It is provided by the
+Gnulib module @samp{c32isxdigit}.
+
 @item mb_isxdigit
 This function operates in a locale dependent way, on multibyte characters.
 It is provided by the Gnulib module @samp{mbchar}.
diff --git a/doc/posix-functions/tolower.texi b/doc/posix-functions/tolower.texi
index d8d2bf7f06..9911b7fb0c 100644
--- a/doc/posix-functions/tolower.texi
+++ b/doc/posix-functions/tolower.texi
@@ -16,7 +16,32 @@ OS X 10.8.
 
 Portability problems not fixed by Gnulib:
 @itemize
-@item
-On Windows and 32-bit AIX platforms, @code{wchar_t} is a 16-bit type and therefore cannot
-accommodate all Unicode characters.
 @end itemize
+
+Note: This function's behaviour depends on the locale, but does not support
+the multibyte characters that occur in strings in locales with
+@code{MB_CUR_MAX > 1} (this includes all the common UTF-8 locales).
+There are four alternative APIs:
+
+@table @code
+@item c_tolower
+This function operates in a locale independent way and returns a different
+value than the argument only for uppercase ASCII characters.  It is provided
+by the Gnulib module @samp{c-ctype}.
+
+@item towlower
+This function operates in a locale dependent way, on wide characters.  In
+order to use it, you first have to convert from multibyte to wide characters,
+using the @code{mbrtowc} function.  It is provided by the Gnulib module
+@samp{wctype}.
+
+@item c32tolower
+This function operates in a locale dependent way, on 32-bit wide characters.
+In order to use it, you first have to convert from multibyte to 32-bit wide
+characters, using the @code{mbrtoc32} function.  It is provided by the
+Gnulib module @samp{c32tolower}.
+
+@item uc_tolower
+This function operates in a locale independent way, on Unicode characters.
+It is provided by the Gnulib module @samp{unicase/tolower}.
+@end table
diff --git a/doc/posix-functions/toupper.texi b/doc/posix-functions/toupper.texi
index 36e40c45bc..86272d3ca0 100644
--- a/doc/posix-functions/toupper.texi
+++ b/doc/posix-functions/toupper.texi
@@ -16,7 +16,32 @@ OS X 10.8.
 
 Portability problems not fixed by Gnulib:
 @itemize
-@item
-On Windows and 32-bit AIX platforms, @code{wchar_t} is a 16-bit type and therefore cannot
-accommodate all Unicode characters.
 @end itemize
+
+Note: This function's behaviour depends on the locale, but does not support
+the multibyte characters that occur in strings in locales with
+@code{MB_CUR_MAX > 1} (this includes all the common UTF-8 locales).
+There are four alternative APIs:
+
+@table @code
+@item c_toupper
+This function operates in a locale independent way and returns a different
+value than the argument only for lowercase ASCII characters.  It is provided
+by the Gnulib module @samp{c-ctype}.
+
+@item towupper
+This function operates in a locale dependent way, on wide characters.  In
+order to use it, you first have to convert from multibyte to wide characters,
+using the @code{mbrtowc} function.  It is provided by the Gnulib module
+@samp{wctype}.
+
+@item c32toupper
+This function operates in a locale dependent way, on 32-bit wide characters.
+In order to use it, you first have to convert from multibyte to 32-bit wide
+characters, using the @code{mbrtoc32} function.  It is provided by the
+Gnulib module @samp{c32toupper}.
+
+@item uc_toupper
+This function operates in a locale independent way, on Unicode characters.
+It is provided by the Gnulib module @samp{unicase/toupper}.
+@end table
diff --git a/doc/posix-functions/towlower.texi b/doc/posix-functions/towlower.texi
index a8ef3ce990..b6c51a4571 100644
--- a/doc/posix-functions/towlower.texi
+++ b/doc/posix-functions/towlower.texi
@@ -23,6 +23,9 @@ Portability problems not fixed by Gnulib:
 @item
 On Windows and 32-bit AIX platforms, @code{wchar_t} is a 16-bit type and therefore cannot
 accommodate all Unicode characters.
+However, the Gnulib function @code{c32tolower}, provided by Gnulib module
+@code{c32tolower}, operates on 32-bit wide characters and therefore does not
+have this limitation.
 @item
 This function returns wrong values even for the ASCII characters
 in a zh_CN.GB18030 locale on some platforms:
diff --git a/doc/posix-functions/towupper.texi b/doc/posix-functions/towupper.texi
index 902cf16e68..bd29eec9ad 100644
--- a/doc/posix-functions/towupper.texi
+++ b/doc/posix-functions/towupper.texi
@@ -23,6 +23,9 @@ Portability problems not fixed by Gnulib:
 @item
 On Windows and 32-bit AIX platforms, @code{wchar_t} is a 16-bit type and therefore cannot
 accommodate all Unicode characters.
+However, the Gnulib function @code{c32toupper}, provided by Gnulib module
+@code{c32toupper}, operates on 32-bit wide characters and therefore does not
+have this limitation.
 @item
 This function returns wrong values even for the ASCII characters
 in a zh_CN.GB18030 locale on some platforms:
diff --git a/doc/posix-functions/wcswidth.texi b/doc/posix-functions/wcswidth.texi
index eab3393a60..02049ffdd0 100644
--- a/doc/posix-functions/wcswidth.texi
+++ b/doc/posix-functions/wcswidth.texi
@@ -18,4 +18,7 @@ Portability problems not fixed by Gnulib:
 @item
 On Windows and 32-bit AIX platforms, @code{wchar_t} is a 16-bit type and therefore cannot
 accommodate all Unicode characters.
+However, the Gnulib function @code{c32swidth}, provided by Gnulib module
+@code{c32swidth}, operates on 32-bit wide characters and therefore does not
+have this limitation.
 @end itemize
diff --git a/doc/posix-functions/wcwidth.texi b/doc/posix-functions/wcwidth.texi
index b68cb78015..1ec5f48197 100644
--- a/doc/posix-functions/wcwidth.texi
+++ b/doc/posix-functions/wcwidth.texi
@@ -29,6 +29,9 @@ Portability problems not fixed by Gnulib:
 @item
 On Windows and 32-bit AIX platforms, @code{wchar_t} is a 16-bit type and therefore cannot
 accommodate all Unicode characters.
+However, the Gnulib function @code{c32width}, provided by Gnulib module
+@code{c32width}, operates on 32-bit wide characters and therefore does not
+have this limitation.
 @item
 This function treats zero-width spaces like control characters on some
 platforms: