From: Eugene Syromyatnikov <evgsyr@gmail.com>
To: mtk.manpages@gmail.com
Cc: linux-man@vger.kernel.org
Subject: [PATCH] strftime.3: consistently document fall-back format string
Date: Fri, 14 Feb 2020 16:28:58 +0100 [thread overview]
Message-ID: <00f5f714c73adf931d1b331a7f3724e4a0683c18.1581693625.git.evgsyr@gmail.com> (raw)
In-Reply-To: <cover.1581693624.git.evgsyr@gmail.com>
The information is taken from POSIX[1] and the implementations[2][3][4].
[1] https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap07.html#tag_07_03_05_03
[2] https://sourceware.org/git/?p=glibc.git;a=blob;f=time/strftime_l.c
[3] https://git.musl-libc.org/cgit/musl/tree/src/locale/langinfo.c#n15
[4] https://git.uclibc.org/uClibc/tree/libc/misc/locale/locale.c#n992
* man3/strftime.3 (%c, %x, %X): Add information about fall-back format.
(%r): Move it behind SU comment.
Signed-off-by: Eugene Syromyatnikov <evgsyr@gmail.com>
---
man3/strftime.3 | 10 ++++++++--
1 file changed, 8 insertions(+), 2 deletions(-)
diff --git a/man3/strftime.3 b/man3/strftime.3
index 62b77bf..dd7dec7 100644
--- a/man3/strftime.3
+++ b/man3/strftime.3
@@ -107,6 +107,8 @@ The full month name according to the current locale.
.TP
.B %c
The preferred date and time representation for the current locale.
+(In the POSIX locale this is equivalent to
+.BR "%a %b %e %H:%M:%S %Y" .)
.TP
.B %C
The century number (year/100) as a 2-digit integer. (SU)
@@ -240,9 +242,9 @@ string for the current locale.
.TP
.B %r
The time in a.m. or p.m. notation.
-In the POSIX locale this is equivalent to
-.BR "%I:%M:%S %p" .
(SU)
+(In the POSIX locale this is equivalent to
+.BR "%I:%M:%S %p" .)
.TP
.B %R
The time in 24-hour notation
@@ -324,9 +326,13 @@ and
.TP
.B %x
The preferred date representation for the current locale without the time.
+(In the POSIX locale this is equivalent to
+.BR %m/%d/%y .)
.TP
.B %X
The preferred time representation for the current locale without the date.
+(In the POSIX locale this is equivalent to
+.BR %H:%M:%S .)
.TP
.B %y
The year as a decimal number without a century (range 00 to 99).
--
2.1.4
next prev parent reply other threads:[~2020-02-14 15:29 UTC|newest]
Thread overview: 15+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-02-14 15:28 [PATCH] Some stftime.3 and nl_langinfo.3 updates Eugene Syromyatnikov
2020-02-14 15:28 ` [PATCH] nl_langinfo.3: mention the respective strftime conversion specifications Eugene Syromyatnikov
2020-02-23 21:14 ` Michael Kerrisk (man-pages)
2020-02-14 15:28 ` [PATCH] nl_langinfo.3: add information about AM/PM time format locale elements Eugene Syromyatnikov
2020-02-23 21:15 ` Michael Kerrisk (man-pages)
2020-02-14 15:28 ` [PATCH] nl_langinfo.3: document era-related " Eugene Syromyatnikov
2020-02-23 21:23 ` Michael Kerrisk (man-pages)
2020-02-14 15:28 ` [PATCH] strftime.3: ffix Eugene Syromyatnikov
2020-02-23 21:26 ` Michael Kerrisk (man-pages)
2020-02-14 15:28 ` Eugene Syromyatnikov [this message]
2020-02-23 21:27 ` [PATCH] strftime.3: consistently document fall-back format string Michael Kerrisk (man-pages)
2020-02-14 15:29 ` [PATCH] strftime.3: refer to the relevant nl_langinfo items Eugene Syromyatnikov
2020-02-23 21:32 ` Michael Kerrisk (man-pages)
2020-02-14 15:29 ` [PATCH] strftime.3: expand %E and %O description Eugene Syromyatnikov
2020-02-23 21:43 ` Michael Kerrisk (man-pages)
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=00f5f714c73adf931d1b331a7f3724e4a0683c18.1581693625.git.evgsyr@gmail.com \
--to=evgsyr@gmail.com \
--cc=linux-man@vger.kernel.org \
--cc=mtk.manpages@gmail.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).