{"id":815423,"url":"http://patchwork.ozlabs.org/api/1.2/patches/815423/?format=json","web_url":"http://patchwork.ozlabs.org/project/glibc/patch/1489658352.1095088.1505817931266@poczta.nazwa.pl/","project":{"id":41,"url":"http://patchwork.ozlabs.org/api/1.2/projects/41/?format=json","name":"GNU C Library","link_name":"glibc","list_id":"libc-alpha.sourceware.org","list_email":"libc-alpha@sourceware.org","web_url":"","scm_url":"","webscm_url":"","list_archive_url":"","list_archive_url_format":"","commit_url_format":""},"msgid":"<1489658352.1095088.1505817931266@poczta.nazwa.pl>","list_archive_url":null,"date":"2017-09-19T10:45:31","name":"[RFC,v9,6/6] Documentation to the above changes (bug 10871).","commit_ref":null,"pull_url":null,"state":"new","archived":false,"hash":"daa80eb63ea16966a2015aa1ee988654dbd442bd","submitter":{"id":67752,"url":"http://patchwork.ozlabs.org/api/1.2/people/67752/?format=json","name":"Rafal Luzynski","email":"digitalfreak@lingonborough.com"},"delegate":null,"mbox":"http://patchwork.ozlabs.org/project/glibc/patch/1489658352.1095088.1505817931266@poczta.nazwa.pl/mbox/","series":[{"id":3831,"url":"http://patchwork.ozlabs.org/api/1.2/series/3831/?format=json","web_url":"http://patchwork.ozlabs.org/project/glibc/list/?series=3831","date":"2017-09-19T10:39:23","name":"Month names in alternative grammatical case","version":9,"mbox":"http://patchwork.ozlabs.org/series/3831/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/815423/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/815423/checks/","tags":{},"related":[],"headers":{"Return-Path":"<libc-alpha-return-84717-incoming=patchwork.ozlabs.org@sourceware.org>","X-Original-To":"incoming@patchwork.ozlabs.org","Delivered-To":["patchwork-incoming@bilbo.ozlabs.org","mailing list libc-alpha@sourceware.org"],"Authentication-Results":["ozlabs.org;\n\tspf=pass (mailfrom) smtp.mailfrom=sourceware.org\n\t(client-ip=209.132.180.131; helo=sourceware.org;\n\tenvelope-from=libc-alpha-return-84717-incoming=patchwork.ozlabs.org@sourceware.org;\n\treceiver=<UNKNOWN>)","ozlabs.org; dkim=pass (1024-bit key;\n\tsecure) header.d=sourceware.org header.i=@sourceware.org\n\theader.b=\"pHMVZ9aQ\"; dkim-atps=neutral","sourceware.org; auth=none"],"Received":["from sourceware.org (server1.sourceware.org [209.132.180.131])\n\t(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256\n\tbits)) (No client certificate requested)\n\tby ozlabs.org (Postfix) with ESMTPS id 3xxKL23GBDz9s82\n\tfor <incoming@patchwork.ozlabs.org>;\n\tTue, 19 Sep 2017 20:46:18 +1000 (AEST)","(qmail 127569 invoked by alias); 19 Sep 2017 10:46:08 -0000","(qmail 101600 invoked by uid 89); 19 Sep 2017 10:45:38 -0000"],"DomainKey-Signature":"a=rsa-sha1; c=nofws; d=sourceware.org; h=list-id\n\t:list-unsubscribe:list-subscribe:list-archive:list-post\n\t:list-help:sender:date:from:reply-to:to:message-id:subject\n\t:mime-version:content-type:content-transfer-encoding; q=dns; s=\n\tdefault; b=PuWkTEmGZWyIIECoQ7cTlcg8xzWreu4ZJtyS5owuBxHi9iVD73Hhi\n\tq0T4riYcQ+XLZc8dj63A79fXBueTs+AZE9llmDYfCzLriX/EtgyxRzoU5jgdX+rs\n\toSBGbfHm2Krzdlx7xbBRRybI4d6qEHqFfl6VfT9ewQEcJTg+Cte0iE=","DKIM-Signature":"v=1; a=rsa-sha1; c=relaxed; d=sourceware.org; h=list-id\n\t:list-unsubscribe:list-subscribe:list-archive:list-post\n\t:list-help:sender:date:from:reply-to:to:message-id:subject\n\t:mime-version:content-type:content-transfer-encoding; s=default;\n\tbh=S3ztYb0fm44cTCBYxJwjzQdYQE8=; b=pHMVZ9aQeJb1ohAoI0lEtnwUPGaC\n\tv4MSq0dbeMy+lPpxqHtBOnCVeaQlddLGrv5UPhfaUiwBEv7L0EsdCyGPD+A/P4Cy\n\t81EPSnIX8Sq0jHQofYTkG22pdVu2jsXBOBxTqA/9DDouCS9TRsf5x/o9c7VwS01R\n\t95PY/kmFzivFLsM=","Mailing-List":"contact libc-alpha-help@sourceware.org; run by ezmlm","Precedence":"bulk","List-Id":"<libc-alpha.sourceware.org>","List-Unsubscribe":"<mailto:libc-alpha-unsubscribe-incoming=patchwork.ozlabs.org@sourceware.org>","List-Subscribe":"<mailto:libc-alpha-subscribe@sourceware.org>","List-Archive":"<http://sourceware.org/ml/libc-alpha/>","List-Post":"<mailto:libc-alpha@sourceware.org>","List-Help":"<mailto:libc-alpha-help@sourceware.org>,\n\t<http://sourceware.org/ml/#faqs>","Sender":"libc-alpha-owner@sourceware.org","X-Virus-Found":"No","X-Spam-SWARE-Status":"No, score=-23.8 required=5.0 tests=AWL, BAYES_00,\n\tGIT_PATCH_0, GIT_PATCH_1, GIT_PATCH_2, GIT_PATCH_3,\n\tKAM_LAZY_DOMAIN_SECURITY autolearn=ham version=3.3.2 spammy=Major,\n\tmonth","X-HELO":"aev204.rev.netart.pl","X-Spam-Score":"2.3","Date":"Tue, 19 Sep 2017 12:45:31 +0200 (CEST)","From":"Rafal Luzynski <digitalfreak@lingonborough.com>","Reply-To":"Rafal Luzynski <digitalfreak@lingonborough.com>","To":"libc-alpha@sourceware.org","Message-ID":"<1489658352.1095088.1505817931266@poczta.nazwa.pl>","Subject":"[RFC][PATCH v9 6/6] Documentation to the above changes (bug 10871).","MIME-Version":"1.0","Content-Type":"text/plain; charset=UTF-8","Content-Transfer-Encoding":"7bit","X-Originating-Client":"com.openexchange.ox.gui.dhtml"},"content":"[BZ#10871]\n\t* manual/locale.texi (nl_langinfo): Document ALTMON_1..12,\n\tprecise details about ABMON_1..12 and MON_1..12.\n\t* manual/time.texi (strftime): Document \"%OB\" and \"%Ob\" format\n\tspecifiers, precise details about \"%B\" and \"%b\".\n---\n ChangeLog          |  8 ++++++++\n NEWS               | 13 +++++++++++++\n manual/locale.texi | 23 ++++++++++++++++++++++-\n manual/time.texi   | 22 ++++++++++++++++++----\n 4 files changed, 61 insertions(+), 5 deletions(-)","diff":"diff --git a/ChangeLog b/ChangeLog\nindex 9ed2a8b..68b9e47 100644\n--- a/ChangeLog\n+++ b/ChangeLog\n@@ -1,6 +1,14 @@\n 2017-09-19  Rafal Luzynski  <digitalfreak@lingonborough.com>\n \n \t[BZ #10871]\n+\t* manual/locale.texi (nl_langinfo): Document ALTMON_1..12,\n+\tprecise details about ABMON_1..12 and MON_1..12.\n+\t* manual/time.texi (strftime): Document \"%OB\" and \"%Ob\" format\n+\tspecifiers, precise details about \"%B\" and \"%b\".\n+\n+2017-09-19  Rafal Luzynski  <digitalfreak@lingonborough.com>\n+\n+\t[BZ #10871]\n \t* locale/programs/locfile-kw.h: Regenerated for ab_alt_mon.\n \n 2017-09-19  Rafal Luzynski  <digitalfreak@lingonborough.com>\ndiff --git a/NEWS b/NEWS\nindex dd381f8..552bb7e 100644\n--- a/NEWS\n+++ b/NEWS\n@@ -20,6 +20,19 @@ Major new features:\n   leads to lower overall process restart latency, so there is benefit both\n   from a security and performance perspective.\n \n+* Support of two grammatical forms of month names has been added.\n+  It has been precised that the month names returned by nl_langinfo with\n+  MON_1..12 and ABMON_1..12, and formatted by strftime with \"%B\" and \"%b\"\n+  format specifiers are in the grammatical form used when the month forms\n+  part of a complete date.  New series of valid arguments have been added\n+  to nl_langinfo: ALTMON_1..12 and _NL_ABALTMON_1..12 and the \"O\" modifier\n+  is supported with \"%B\" and \"%b\" format specifiers by strftime, they\n+  generate the month names in the grammatical form used when the month is\n+  named by itself.  This feature is required by several languages, mostly\n+  Slavic and Baltic but also Greek and probably more.  In other languages\n+  which do not need this feature the output month names will be the same\n+  for both old and new arguments of nl_langinfo and strftime.\n+\n Deprecated and removed features, and other changes affecting compatibility:\n \n * On GNU/Linux, the obsolete Linux constant PTRACE_SEIZE_DEVEL is no longer\ndiff --git a/manual/locale.texi b/manual/locale.texi\nindex f7a40c2..b61c709 100644\n--- a/manual/locale.texi\n+++ b/manual/locale.texi\n@@ -937,7 +937,8 @@ unabbreviated weekday name.\n @itemx ABMON_10\n @itemx ABMON_11\n @itemx ABMON_12\n-The return value is abbreviated name of the month.  @code{ABMON_1}\n+The return value is abbreviated name of the month, in the grammatical form\n+used when the month forms part of a complete date.  @code{ABMON_1}\n corresponds to January.\n @item MON_1\n @itemx MON_2\n@@ -953,6 +954,26 @@ corresponds to January.\n @itemx MON_12\n Similar to @code{ABMON_1} etc., but here the month names are not abbreviated.\n Here the first value @code{MON_1} also corresponds to January.\n+@item ALTMON_1\n+@itemx ALTMON_2\n+@itemx ALTMON_3\n+@itemx ALTMON_4\n+@itemx ALTMON_5\n+@itemx ALTMON_6\n+@itemx ALTMON_7\n+@itemx ALTMON_8\n+@itemx ALTMON_9\n+@itemx ALTMON_10\n+@itemx ALTMON_11\n+@itemx ALTMON_12\n+Similar to @code{MON_1} etc., but here the month names are in the grammatical\n+form used when the month is named by itself.  The @code{strftime} functions\n+use this information when the modifier @code{O} is used in a format specifier\n+@code{B}.  Here the first value @code{ALTMON_1} also corresponds to January.\n+\n+Note that in locales which do not need different grammatical forms of the\n+month names (including English) the return values are identical to those\n+returned by the corresponding @code{MON_@dots{}} values.\n @item AM_STR\n @itemx PM_STR\n The return values are strings which can be used in the representation of time\ndiff --git a/manual/time.texi b/manual/time.texi\nindex 33aa221..396934e 100644\n--- a/manual/time.texi\n+++ b/manual/time.texi\n@@ -1347,7 +1347,10 @@ Emperors' reigns.\n \n @item O\n Use the locale's alternate numeric symbols for numbers.  This modifier\n-applies only to numeric format specifiers.\n+applies only to numeric format specifiers.  Additionally, as a GNU extension,\n+this modifier also applies to the @code{%b} and @code{%B} format specifiers\n+and forces the use of month names in the grammatical form used when the month\n+is named by itself.\n @end table\n \n If the format supports the modifier but no alternate representation\n@@ -1366,12 +1369,21 @@ The full weekday name according to the current locale.\n \n @item %b\n The abbreviated month name according to the current locale.\n+As a GNU extension, it is specified that the abbreviated month name is\n+produced in the grammatical form used when the month forms part of a complete\n+date; applying the @code{O} modifier produces the abbreviated month name in\n+the grammatical form used when the month is named by itself.\n \n @item %B\n The full month name according to the current locale.\n+As a GNU extension, it is specified that the full month name is produced in\n+the grammatical form used when the month forms part of a complete date;\n+applying the @code{O} modifier produces the abbreviated month name in the\n+grammatical form used when the month is named by itself.\n \n-Using @code{%B} together with @code{%d} produces grammatically\n-incorrect results for some locales.\n+Note that most of the locales do not need different grammatical forms of the\n+month names.  In these locales the @code{O} modifier does not change the\n+results of the @code{%b} and @code{%B} specifiers.\n \n @item %c\n The preferred calendar time representation for the current locale.\n@@ -1779,7 +1791,9 @@ the full name.\n @itemx %B\n @itemx %h\n The month name according to the current locale, in abbreviated form or\n-the full name.\n+the full name.  If the current locale requires different grammatical forms of\n+the month names then both forms are accepted, does not matter if the @code{O}\n+modifier is present or not.\n \n @item %c\n The date and time representation for the current locale.\n","prefixes":["RFC","v9","6/6"]}