diff options
| author | Joseph Myers <joseph@codesourcery.com> | 2019-08-22 12:38:40 +0000 |
|---|---|---|
| committer | Joseph Myers <joseph@codesourcery.com> | 2019-08-22 12:38:40 +0000 |
| commit | c737ef0d647fa5a3a290d2b77fe25fa8ba5b9cb9 (patch) | |
| tree | 5f5c6c774bc22f75d8dece1676446ee3fa7bcd21 /manual | |
| parent | f615e3fced100914b1ee4d690f380deb69a4be70 (diff) | |
| download | glibc-c737ef0d647fa5a3a290d2b77fe25fa8ba5b9cb9.tar glibc-c737ef0d647fa5a3a290d2b77fe25fa8ba5b9cb9.tar.gz glibc-c737ef0d647fa5a3a290d2b77fe25fa8ba5b9cb9.tar.bz2 glibc-c737ef0d647fa5a3a290d2b77fe25fa8ba5b9cb9.zip | |
Document strftime %Ob and %OB as C2X features.
C2X standardizes strftime %Ob and %OB support. This patch updates the
glibc manual to say these are C2X features, while noting that the
details of what is the alternative form of a month name are not
specified in C2X.
Note: C2X seems unclear to me about whether %h being equivalent to %b
means %Oh is thereby allowed and equivalent to %Ob; I've asked WG14.
Tested with "make info" and "make pdf".
* manual/time.texi (strftime): Document %Ob and %OB as C2X
features.
Diffstat (limited to 'manual')
| -rw-r--r-- | manual/time.texi | 16 |
1 files changed, 11 insertions, 5 deletions
diff --git a/manual/time.texi b/manual/time.texi index bfa46dd45b..c5f5b94b67 100644 --- a/manual/time.texi +++ b/manual/time.texi @@ -1352,7 +1352,11 @@ alternative numeric symbols. 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. +part of a complete date. The @code{%OB} and @code{%Ob} formats are a +C2X feature, specified in C2X to use the locale's `alternative' month +name; @theglibc{} extends this specification to say that the form used +in a complete date is the default and the form naming the month by +itself is the alternative. @end table If the format supports the modifier but no alternative representation @@ -1372,14 +1376,16 @@ The full weekday name according to the current locale. @item %b The abbreviated month name according to the current locale, in the grammatical form used when the month is part of a complete date. -As a GNU extension, the @code{O} modifier can be used (@code{%Ob}) -to get the grammatical form used when the month is named by itself. +As a C2X feature (with a more detailed specification in @theglibc{}), +the @code{O} modifier can be used (@code{%Ob}) to get the grammatical +form used when the month is named by itself. @item %B The full month name according to the current locale, in the grammatical form used when the month is part of a complete date. -As a GNU extension, the @code{O} modifier can be used (@code{%OB}) -to get the grammatical form used when the month is named by itself. +As a C2X feature (with a more detailed specification in @theglibc{}), +the @code{O} modifier can be used (@code{%OB}) to get the grammatical +form used when the month is named by itself. Note that not all languages need two different forms of the month names, so the text produced by @code{%B} and @code{%OB}, and by |