diff options
author | Rical Jasan <ricaljasan@deathguild.net> | 2018-01-22 19:24:24 -0800 |
---|---|---|
committer | Rical Jasan <ricaljasan@deathguild.net> | 2018-01-22 19:36:51 -0800 |
commit | 0f5e2da1608fc1d991f1925392dcdb62c6f6aedd (patch) | |
tree | 763e17ac408f167a9c99ad63b0826938b5f0968f | |
parent | 25fb7dd6511f0f6eb3793215dbcb76f65cb80347 (diff) | |
download | glibc-0f5e2da1608fc1d991f1925392dcdb62c6f6aedd.tar.gz glibc-0f5e2da1608fc1d991f1925392dcdb62c6f6aedd.tar.xz glibc-0f5e2da1608fc1d991f1925392dcdb62c6f6aedd.zip |
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.
-rw-r--r-- | ChangeLog | 7 | ||||
-rw-r--r-- | manual/locale.texi | 25 | ||||
-rw-r--r-- | manual/time.texi | 8 |
3 files changed, 27 insertions, 13 deletions
diff --git a/ChangeLog b/ChangeLog index 7b518b269a..c09316d57e 100644 --- a/ChangeLog +++ b/ChangeLog @@ -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> [BZ #10871] diff --git a/manual/locale.texi b/manual/locale.texi index 059db75c1c..dabb959f9e 100644 --- a/manual/locale.texi +++ b/manual/locale.texi @@ -923,7 +923,7 @@ corresponds to Sunday. @itemx DAY_5 @itemx DAY_6 @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. @item ABMON_1 @itemx ABMON_2 @@ -937,9 +937,9 @@ unabbreviated weekday name. @itemx ABMON_10 @itemx ABMON_11 @itemx ABMON_12 -The return value is the abbreviated name of the month, in the grammatical -form used when the month forms part of a complete date. @code{ABMON_1} -corresponds to January. +The return value is the abbreviated name of the month, in the +grammatical form used when the month forms part of a complete date. +@code{ABMON_1} corresponds to January. @item MON_1 @itemx MON_2 @itemx MON_3 @@ -952,8 +952,9 @@ corresponds to January. @itemx MON_10 @itemx MON_11 @itemx MON_12 -Similar to @code{ABMON_1} etc.,@: but here the month names are not abbreviated. -Here the first value @code{MON_1} also corresponds to January. +Similar to @code{ABMON_1}, etc.,@: but here the month names are not +abbreviated. Here the first value @code{MON_1} also corresponds to +January. @item ALTMON_1 @itemx ALTMON_2 @itemx ALTMON_3 @@ -966,13 +967,19 @@ Here the first value @code{MON_1} also corresponds to January. @itemx ALTMON_10 @itemx ALTMON_11 @itemx ALTMON_12 -Similar to @code{MON_1} etc.,@: but here the month names are in the grammatical -form used when the month is named by itself. The @code{strftime} functions -use these month names for the format specifier @code{OB}. +Similar to @code{MON_1}, etc.,@: but here the month names are in the +grammatical form used when the month is named by itself. The +@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, so the strings returned for @code{MON_@dots{}} and @code{ALTMON_@dots{}} 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 @itemx PM_STR The return values are strings which can be used in the representation of time diff --git a/manual/time.texi b/manual/time.texi index 2a5afd9e56..4d154452eb 100644 --- a/manual/time.texi +++ b/manual/time.texi @@ -1349,10 +1349,10 @@ Emperors' reigns. With all format specifiers that produce numbers: use the locale's alternate numeric symbols. -With @code{%B} and @code{%b}: use the grammatical form for month names -that is appropriate when the month is named by itself, rather than -the form that is appropriate when the month is used as part of a -complete date. This is a GNU extension. +With @code{%B}, @code{%b}, and @code{%h}: use the grammatical form for +month names that is appropriate when the month is named by itself, +rather than the form that is appropriate when the month is used as +part of a complete date. This is a GNU extension. @end table If the format supports the modifier but no alternate representation |