[Emacs-diffs] master ab980bd: Mention locale-related complications in format-time-string doc string

[Lars Ingebrigtsen]

branch: master
commit ab980bd7f5f9ec396ec84254bece6048f36ad8ff
Author: Lars Ingebrigtsen <address@hidden>
Commit: Lars Ingebrigtsen <address@hidden>

    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).
---
 src/timefns.c | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/src/timefns.c b/src/timefns.c
index 330d562..9509b6b 100644
--- 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: