OpenE2K
/
glibc
2
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

manual: Touch up documentation for strftime and ALTMON_* constants. 

"%OB" is considered a conversion specifier ("B" is the format
specifier), and the list of format specifiers for months in the
description of the optional "O" modifier was incomplete.  A
cross-reference from the ALTMON_* constants to the strftime section
is also provided.  Lastly, some grammatical fixes (commas) are made
and paragraphs refactored (rewrapped).

	* manual/locale.texi (ALTMON_1, ALTMON_2, ALTMON_3, ALTMON_4,
	ALTMON_5, ALTMON_6, ALTMON_7, ALTMON_8, ALTMON_9, ALTMON_10,
	ALTMON_11, ALTMON_12): Improve documentation.
	* manual/time.texi (strftime): Likewise.
This commit is contained in:
Rical Jasan 2018-01-22 19:24:24 -08:00
parent 25fb7dd651
commit 0f5e2da160
3 changed files with 27 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
ChangeLog
View File

@ -1,3 +1,10 @@
2018-01-22 Rical Jasan <ricaljasan@pacific.net>
* manual/locale.texi (ALTMON_1, ALTMON_2, ALTMON_3, ALTMON_4)
(ALTMON_5, ALTMON_6, ALTMON_7, ALTMON_8, ALTMON_9, ALTMON_10)
(ALTMON_11, ALTMON_12): Improve documentation.
* manual/time.texi (strftime): Likewise.
2018-01-22 Rafal Luzynski <digitalfreak@lingonborough.com> 2018-01-22 Rafal Luzynski <digitalfreak@lingonborough.com>
[BZ #10871] [BZ #10871]

25
manual/locale.texi
View File

@ -923,7 +923,7 @@ corresponds to Sunday.
@itemx DAY_5 @itemx DAY_5
@itemx DAY_6 @itemx DAY_6
@itemx DAY_7 @itemx DAY_7
Similar to @code{ABDAY_1} etc.,@: but here the return value is the Similar to @code{ABDAY_1}, etc.,@: but here the return value is the
unabbreviated weekday name. unabbreviated weekday name.
@item ABMON_1 @item ABMON_1
@itemx ABMON_2 @itemx ABMON_2
@ -937,9 +937,9 @@ unabbreviated weekday name.
@itemx ABMON_10 @itemx ABMON_10
@itemx ABMON_11 @itemx ABMON_11
@itemx ABMON_12 @itemx ABMON_12
The return value is the abbreviated name of the month, in the grammatical The return value is the abbreviated name of the month, in the
form used when the month forms part of a complete date. @code{ABMON_1} grammatical form used when the month forms part of a complete date.
corresponds to January. @code{ABMON_1} corresponds to January.
@item MON_1 @item MON_1
@itemx MON_2 @itemx MON_2
@itemx MON_3 @itemx MON_3
@ -952,8 +952,9 @@ corresponds to January.
@itemx MON_10 @itemx MON_10
@itemx MON_11 @itemx MON_11
@itemx MON_12 @itemx MON_12
Similar to @code{ABMON_1} etc.,@: but here the month names are not abbreviated. Similar to @code{ABMON_1}, etc.,@: but here the month names are not
Here the first value @code{MON_1} also corresponds to January. abbreviated. Here the first value @code{MON_1} also corresponds to
January.
@item ALTMON_1 @item ALTMON_1
@itemx ALTMON_2 @itemx ALTMON_2
@itemx ALTMON_3 @itemx ALTMON_3
@ -966,13 +967,19 @@ Here the first value @code{MON_1} also corresponds to January.
@itemx ALTMON_10 @itemx ALTMON_10
@itemx ALTMON_11 @itemx ALTMON_11
@itemx ALTMON_12 @itemx ALTMON_12
Similar to @code{MON_1} etc.,@: but here the month names are in the grammatical Similar to @code{MON_1}, etc.,@: but here the month names are in the
form used when the month is named by itself. The @code{strftime} functions grammatical form used when the month is named by itself. The
use these month names for the format specifier @code{OB}. @code{strftime} functions use these month names for the conversion
specifier @code{%OB} (@pxref{Formatting Calendar Time}).
Note that not all languages need two different forms of the month names, Note that not all languages need two different forms of the month names,
so the strings returned for @code{MON_@dots{}} and @code{ALTMON_@dots{}} so the strings returned for @code{MON_@dots{}} and @code{ALTMON_@dots{}}
may or may not be the same, depending on the locale. may or may not be the same, depending on the locale.
@strong{NB:} @code{ABALTMON_@dots{}} constants corresponding to the
@code{%Ob} conversion specifier are not currently provided, but are
expected to be in a future release. In the meantime, it is possible
to use @code{_NL_ABALTMON_@dots{}}.
@item AM_STR @item AM_STR
@itemx PM_STR @itemx PM_STR
The return values are strings which can be used in the representation of time The return values are strings which can be used in the representation of time

8
manual/time.texi
View File

@ -1349,10 +1349,10 @@ Emperors' reigns.
With all format specifiers that produce numbers: use the locale's With all format specifiers that produce numbers: use the locale's
alternate numeric symbols. alternate numeric symbols.
With @code{%B} and @code{%b}: use the grammatical form for month names With @code{%B}, @code{%b}, and @code{%h}: use the grammatical form for
that is appropriate when the month is named by itself, rather than month names that is appropriate when the month is named by itself,
the form that is appropriate when the month is used as part of a rather than the form that is appropriate when the month is used as
complete date. This is a GNU extension. part of a complete date. This is a GNU extension.
@end table @end table
If the format supports the modifier but no alternate representation If the format supports the modifier but no alternate representation