* man3/strftime.3 (%C): Descibe the meaning of %EC conversion
specification.
(%E): Mention the concept of "era" in description.
(%O): Mention that alternative format is related to numeric
representation.
(%y): Describe the meaning of %Ey conversion specification.
(%Y): Describe the meaning of %EY conversion specification.
(.SH DESCRIPTION): Mention that the behaviour of %E modifier is governed
by ERA locale element and provide ja_JP locale as an example.
Signed-off-by: Eugene Syromyatnikov <evgsyr@xxxxxxxxx>
---
man3/strftime.3 | 29 ++++++++++++++++++++++++++---
1 file changed, 26 insertions(+), 3 deletions(-)
diff --git a/man3/strftime.3 b/man3/strftime.3
index 20ba057..bdbea68 100644
--- a/man3/strftime.3
+++ b/man3/strftime.3
@@ -143,6 +143,9 @@ conversion specification.)
.TP
.B %C
The century number (year/100) as a 2-digit integer. (SU)
+(The
+.B %EC
+conversion specification corresponds to the name of the era.)
(Calculated from
.IR tm_year .)
.TP
@@ -170,7 +173,7 @@ zero is replaced by a space. (SU)
.IR tm_mday .)
.TP
.B %E
-Modifier: use alternative format, see below. (SU)
+Modifier: use alternative ("era-based") format, see below. (SU)
.TP
.B %F
Equivalent to
@@ -253,7 +256,7 @@ The minute as a decimal number (range 00 to 59).
A newline character. (SU)
.TP
.B %O
-Modifier: use alternative format, see below. (SU)
+Modifier: use alternative numeric symbols, see below. (SU)
.TP
.B %p
Either "AM" or "PM" according to the given time value, or the
@@ -400,11 +403,20 @@ conversion specification.)
.TP
.B %y
The year as a decimal number without a century (range 00 to 99).
+(The
+.B %Ey
+conversion specification corresponds to the year since the beginning of the era
+denoted by
+.B %EC
+conversion specification.)
(Calculated from
.IR tm_year )
.TP
.B %Y
The year as a decimal number including the century.
+(The
+.B %EY
+conversion specification corresponds to the full alternative year representation.)
(Calculated from
.IR tm_year )
.TP
@@ -463,7 +475,18 @@ where the effect of the
.B O
modifier is to use
alternative numeric symbols (say, roman numerals), and that of the
-E modifier is to use a locale-dependent alternative representation.
+.B E
+modifier is to use a locale-dependent alternative representation.
+The rules governing date representation with the
+.B E
+modifier can be obtained by supplying
+.B ERA
+as an argument to a
+.BR nl_langinfo (3)
+library call.
+One example of such alternative forms is Japanese era calendar scheme in the
+.B ja_JP
+glibc locale.
.SH RETURN VALUE
Provided that the result string,
including the terminating null byte, does not exceed
--
2.1.4
