Mention locale-related complications in format-time-string doc string

* src/timefns.c (Fformat_time_string): Mention that the width in
specifiers like %NX is often in bytes, not characters (bug#20258).

diff --git a/src/timefns.c b/src/timefns.c
index 330d5623f08d777d0394ab9fcc29d15f553f7afd..9509b6b63eb5103a050b2e7575051b24cba1e98e 100644 (file)
--- a/src/timefns.c
+++ b/src/timefns.c
@@ -1437,8 +1437,12 @@ A %-sequence can contain optional flags, field width, and a modifier
 `^' Use upper case characters if possible.
 `#' Use opposite case characters if possible.
 
-A field width N is an unsigned decimal integer with a leading digit nonzero.
-%NX is like %X, but takes up at least N positions.
+A field width N is an unsigned decimal integer with a leading digit
+nonzero.  %NX is like %X, but takes up at least N positions.  The
+field width is (on GNU/Linux and some other systems) in measured in
+bytes, not characters.  It depends on the locale what the width (in
+characters) %NX will end up being, especially when there are non-ASCII
+characters in %X.
 
 The modifiers are: