[PATCH] doc: mention setlocale() issues on OpenBSD

[Pádraig Brady]

* doc/posix-functions/setlocale.texi: Mention setlocale(LC_ALL,"")
never fails, and the need to check categories individually.
---
 ChangeLog                          | 6 ++++++
 doc/posix-functions/setlocale.texi | 8 ++++++++
 2 files changed, 14 insertions(+)

diff --git a/ChangeLog b/ChangeLog
index b19edb1..27de588 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,11 @@
 2016-01-14  Pádraig Brady  <address@hidden>
 
+       doc: mention setlocale() issues on OpenBSD
+       * doc/posix-functions/setlocale.texi: Mention setlocale(LC_ALL,"")
+       never fails, and the need to check categories individually.
+
+2016-01-14  Pádraig Brady  <address@hidden>
+
        sig2str: list all signals on FreeBSD >= 7
        FreeBSD >= 7 is contravening POSIX by not defining NSIG
        to the maximal statically defined signal value.
diff --git a/doc/posix-functions/setlocale.texi 
b/doc/posix-functions/setlocale.texi
index ee4d477..61ee88b 100644
--- a/doc/posix-functions/setlocale.texi
+++ b/doc/posix-functions/setlocale.texi
@@ -29,4 +29,12 @@ On Cygwin 1.5.x, which doesn't have locales,
 @code{setlocale(LC_ALL,NULL)} always returns @code{"C"}.
 @item
 On Cygwin 1.7.0, only the charset portion of a locale designation is honored.
address@hidden
+On OpenBSD, @code{setlocale(LC_ALL,"")} will only update categories that
+are deemed appropriate for the LC_ALL environment value, even if
+there are other categories set to different values in the environment.
+In addition any value is accepted for LC_CTYPE, and so NULL
+is never returned to indicate a failure to set locale.
+To verify category values, each category must be set individually
+with @code{setlocale(LC_COLLATE,"")} etc.
 @end itemize
-- 
2.5.0