Hello Eugene, On 2/14/20 4:28 PM, Eugene Syromyatnikov wrote: > Information is mostly taken from POSIX[1], GNU C Library documentation[2], > glibc strftime implementation[3], and Japanese locale definition[4]. Thanks. Patch applied. Cheers, Michael > [1] https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap07.html#tag_07_03_05_02 > [2] https://www.gnu.org/software/libc/manual/html_node/The-Elegant-and-Fast-Way.html > [3] https://sourceware.org/git/?p=glibc.git;a=blob;f=time/strftime_l.c > [4] https://sourceware.org/git/?p=glibc.git;a=blob;f=localedata/locales/ja_JP > > * man3/nl_langinfo.3 (.SH DESCRIPTION): Add information about ERA, > ERA_D_T_FMT, ERA_D_FMT, and ERA_T_FMT locale elements. > > Signed-off-by: Eugene Syromyatnikov <evgsyr@xxxxxxxxx> > --- > man3/nl_langinfo.3 | 84 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ > 1 file changed, 84 insertions(+) > > diff --git a/man3/nl_langinfo.3 b/man3/nl_langinfo.3 > index e16b094..3c4541a 100644 > --- a/man3/nl_langinfo.3 > +++ b/man3/nl_langinfo.3 > @@ -119,6 +119,90 @@ to represent a time in a.m. or p.m. notation a locale-specific way > .RB ( %r > conversion specification). > .TP > +.BR ERA \ (LC_TIME) > +Return era description, that contains information how years are counted > +and displayed for each era in a locale. > +Each era description segment shall have the format: > +.RS > +.IP > +.IR direction : offset : start_date : end_date : era_name : era_format > +.RE > +.IP > +according to the definitions below: > +.RS > +.TP 12 > +.I direction > +Either a > +.RB \[dq] + "\[dq] or a \[dq]" - \[dq] > +character. > +The > +.RB \[dq] + \[dq] > +means that years increase from the > +.I start_date > +towards the > +.IR end_date , > +.RB \[dq] - \[dq] > +means the opposite. > +.TP > +.I offset > +The epoch year of the > +.IR start_date . > +.TP > +.I start_date > +A date in the form > +.IR yyyy / mm / dd , > +where > +.IR yyyy ", " mm ", and " dd > +are the year, month, and day numbers respectively of the start of the era. > +.TP > +.I end_date > +The ending date of the era, in the same format as the > +.IR start_date , > +or one of the two special values > +.RB \[dq] -* \[dq] > +(minus infinity) or > +.RB \[dq] +* \[dq] > +(plus infinity). > +.TP > +.I era_name > +The name of the era, corresponding to the > +.B %EC > +.BR strftime (3) > +conversion specification. > +.TP > +.I era_format > +The format of the year in the era, corresponding to the > +.B %EY > +.BR strftime (3) > +conversion specification. > +.RE > +.IP > +Era description segments are separated by semicolons. > +Most locales do not define this value. > +Examples of locales that do define this value are the Japanese and the Thai > +locales. > +.TP > +.BR ERA_D_T_FMT \ (LC_TIME) > +Return a string that can be used as a format string for > +.BR strftime (3) > +for alternative representation of time and date in a locale-specific way > +.RB ( %Ec > +conversion specification). > +.TP > +.BR ERA_D_FMT \ (LC_TIME) > +Return a string that can be used as a format string for > +.BR strftime (3) > +for alternative representation of a date in a locale-specific way > +.RB ( %Ex > +conversion specification). > +.TP > +.BR ERA_T_FMT \ (LC_TIME) > +Return a string that can be used as a format string for > +.BR strftime (3) > +for alternative representation of a time in a locale-specific way > +.RB ( %EX > +conversion specification). > +.TP > .BR DAY_ "{1\(en7} (LC_TIME)" > Return name of the \fIn\fP-th day of the week. [Warning: this follows > the US convention DAY_1 = Sunday, not the international convention > -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/
