[PATCH] btowc: document problems in C locale

[Paul Eggert]

* doc/posix-functions/btowc.texi (btowc): Mention incompatibility
with mbrtowc.  See: http://bugs.gnu.org/23269#32
---
 ChangeLog                      | 6 ++++++
 doc/posix-functions/btowc.texi | 4 ++++
 2 files changed, 10 insertions(+)

diff --git a/ChangeLog b/ChangeLog
index 3bca619..4bccb2f 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2016-04-19  Paul Eggert  <address@hidden>
+
+       btowc: document problems in C locale
+       * doc/posix-functions/btowc.texi (btowc): Mention incompatibility
+       with mbrtowc.  See: http://bugs.gnu.org/23269#32
+
 2016-04-13  Paul Eggert  <address@hidden>
 
        mktime: improve integer overflow checking
diff --git a/doc/posix-functions/btowc.texi b/doc/posix-functions/btowc.texi
index d09d16f..382915a 100644
--- a/doc/posix-functions/btowc.texi
+++ b/doc/posix-functions/btowc.texi
@@ -24,4 +24,8 @@ Portability problems not fixed by Gnulib:
 @item
 On AIX and Windows platforms, @code{wchar_t} is a 16-bit type and therefore 
cannot
 accommodate all Unicode characters.
address@hidden
+In the C or POSIX locales, this function is not consistent with
+Gnulib's @code{mbrtowc} and can return @code{WEOF}:
+glibc 2.23, MirOS BSD #10.
 @end itemize
-- 
2.5.5