summaryrefslogtreecommitdiff
path: root/src/timefns.c
diff options
context:
space:
mode:
authorLars Ingebrigtsen <larsi@gnus.org>2019-09-30 16:47:48 +0200
committerLars Ingebrigtsen <larsi@gnus.org>2019-09-30 16:47:48 +0200
commitab980bd7f5f9ec396ec84254bece6048f36ad8ff (patch)
tree96f96c0f439e2c62a163a0cdb0dcf0675ed19068 /src/timefns.c
parent224c51075dde7f571e996578d15b5a10eeae43ca (diff)
downloademacs-ab980bd7f5f9ec396ec84254bece6048f36ad8ff.tar.gz
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).
Diffstat (limited to 'src/timefns.c')
-rw-r--r--src/timefns.c8
1 files changed, 6 insertions, 2 deletions
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: