From: Lars Ingebrigtsen Date: Mon, 30 Sep 2019 14:47:48 +0000 (+0200) Subject: Mention locale-related complications in format-time-string doc string X-Git-Tag: emacs-27.0.90~1353 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=ab980bd7f5f9ec396ec84254bece6048f36ad8ff;p=emacs.git 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 330d5623f08..9509b6b63eb 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: