[gentoo-commits] data/glep:glep42-update commit in: /

[gentoo-commits] data/glep:glep42-update commit in: /

[Ulrich Müller]

commit:     d554af92dac47eb78c4fd1f62c00fd8c2e0c7c2b
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Sun Nov 26 23:30:49 2017 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Mon Nov 27 09:36:58 2017 +0000
URL:        https://gitweb.gentoo.org/data/glep.git/commit/?id=d554af92

glep-0042: Update and clarify naming rules.

Update the GLEP from ISO 639 to IETF language tags (BCP 47), in order
to make it consistent with usage in the L10N USE_EXPAND variable.
This will make no difference for most common languages. Also there are
currently no translations of news items at all.

Add a note clarifying what "very short" means.

 glep-0042.rst | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/glep-0042.rst b/glep-0042.rst
index 7726ea4..90ae0b2 100644
--- a/glep-0042.rst
+++ b/glep-0042.rst
@@ -179,7 +179,9 @@ form ``yyyy-mm-dd-short-name``, where ``yyyy`` is the year (e.g. ``2005``),
 ``mm`` is the month (``01`` through ``12``) and dd is the day of the month
 (``01`` through ``31``). The ``short-name`` is a very short name describing the
 news item (e.g. ``yoursql-updates``), consisting only of the characters ``a-z``,
-``0-9``, ``+`` (plus), ``-`` (hyphen) and ``_`` (underscore).
+``0-9``, ``+`` (plus), ``-`` (hyphen) and ``_`` (underscore). While there
+is no hard restriction for the length of ``short-name``, it is strongly
+recommended to limit it to at most 20 characters.
 
 News Item Directories
 ---------------------
@@ -191,8 +193,8 @@ The directory will contain a file named ``yyyy-mm-dd-short-name.en.txt``, which
 contains the text of the news item, in English, in the format described below.
 
 If a news item is translated, other files named ``yyyy-mm-dd-short-name.xx.txt``
-(where ``xx`` is the ISO 639 [#iso-639]_ two letter language code, and the date
-remains the same as the original news item) will also be provided. However, only
+(where ``xx`` is a valid IETF language tag [#bcp-47]_, and the date remains
+the same as the original news item) will also be provided. However, only
 the English version of a news item is authoritative.  This anglocentricity is
 justified by precedent [#glep-34]_.
 
@@ -475,6 +477,8 @@ Example Files
 References
 ==========
 
+.. [#bcp-47] BCP 47: "Tags for identifying languages",
+     https://tools.ietf.org/rfc/bcp/bcp47.txt
 .. [#bug-11359] Bugzilla Bug 11359
    "[NEW FEATURE] pkg_postinst/pkg_preinst ewarn/einfo logging",
    https://bugs.gentoo.org/show_bug.cgi?id=11359
@@ -500,7 +504,6 @@ References
 .. [#glep-74] GLEP 74: "Full-tree verification using Manifest files",
      Michał Górny, Robin Hugh Johnson, Ulrich Müller,
      https://www.gentoo.org/glep/glep-0074.html
-.. [#iso-639] ISO 639 "Code for the representation of names of languages"
 .. [#ramereth-repo] "Re: [gentoo-dev] GLEP ??: Critical News Reporting", Lance
      Albertson,
      https://archives.gentoo.org/gentoo-dev/message/4204839d4091758c3bad1dbd18ed16f7

[gentoo-commits] data/glep:glep42-update commit in: /

[Ulrich Müller]

commit:     154acdffad2d8b06b9e3337f016b7c8f8183682f
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Mon Nov 27 10:18:39 2017 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Mon Nov 27 10:18:39 2017 +0000
URL:        https://gitweb.gentoo.org/data/glep.git/commit/?id=154acdff

glep-0042: Update Version and Post-History.

 glep-0042.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/glep-0042.rst b/glep-0042.rst
index 90ae0b2..d5f4191 100644
--- a/glep-0042.rst
+++ b/glep-0042.rst
@@ -7,12 +7,12 @@ Author: Ciaran McCreesh <ciaranm@gentoo.org>,
         Ulrich Müller <ulm@gentoo.org>
 Type: Standards Track
 Status: Final
-Version: 3
+Version: 4
 Created: 2005-10-31
-Last-Modified: 2017-11-26
+Last-Modified: 2017-11-27
 Post-History: 2005-11-01, 2005-11-05, 2005-11-07, 2005-12-11, 2005-12-13,
               2005-12-18, 2006-01-05, 2006-03-02, 2006-03-06, 2006-06-12,
-              2006-09-05, 2016-03-10
+              2006-09-05, 2016-03-10, 2017-11-27
 Content-Type: text/x-rst
 ---
 

[gentoo-commits] data/glep:glep42-update commit in: /

[Ulrich Müller]

commit:     429a6e234b119f018065f10fe5161bc36990a7f7
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Mon Nov 27 14:52:22 2017 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Mon Nov 27 14:52:22 2017 +0000
URL:        https://gitweb.gentoo.org/data/glep.git/commit/?id=429a6e23

glep-0042: Minor corrections.

Thanks to Duncan and Aaron W. Swenson.

 glep-0042.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/glep-0042.rst b/glep-0042.rst
index d5f4191..16c81f8 100644
--- a/glep-0042.rst
+++ b/glep-0042.rst
@@ -179,9 +179,9 @@ form ``yyyy-mm-dd-short-name``, where ``yyyy`` is the year (e.g. ``2005``),
 ``mm`` is the month (``01`` through ``12``) and dd is the day of the month
 (``01`` through ``31``). The ``short-name`` is a very short name describing the
 news item (e.g. ``yoursql-updates``), consisting only of the characters ``a-z``,
-``0-9``, ``+`` (plus), ``-`` (hyphen) and ``_`` (underscore). While there
-is no hard restriction for the length of ``short-name``, it is strongly
-recommended to limit it to at most 20 characters.
+``0-9``, ``+`` (plus), ``-`` (hyphen) and ``_`` (underscore). While there is no
+hard restriction on the length of ``short-name``, limiting it to 20 characters
+is strongly recommended.
 
 News Item Directories
 ---------------------
@@ -211,7 +211,7 @@ various optional and mandatory headers. Future GLEPs may propose new headers —
 tools handling these news items must ignore any unrecognised header.
 
 .. Note:: A previous version of this GLEP had required that news items must
-   be signed with a detached OpenPGP signature. This was no longer deemed
+   be signed with a detached OpenPGP signature. This was deemed no longer
    necessary after moving news items to a Git repository with commit signing,
    and deployment of full-tree verification per GLEP 74 [#glep-74]_.
 

[gentoo-commits] data/glep:glep42-update commit in: /

[Ulrich Müller]

commit:     1e9dfb5a9d0b93b08444e4d31e1f69daf55adbff
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Wed Nov 29 18:28:40 2017 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Wed Nov 29 18:28:40 2017 +0000
URL:        https://gitweb.gentoo.org/data/glep.git/commit/?id=1e9dfb5a

glep-0042: Clarify naming of translated news items.

 glep-0042.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/glep-0042.rst b/glep-0042.rst
index 16c81f8..416bd18 100644
--- a/glep-0042.rst
+++ b/glep-0042.rst
@@ -9,7 +9,7 @@ Type: Standards Track
 Status: Final
 Version: 4
 Created: 2005-10-31
-Last-Modified: 2017-11-27
+Last-Modified: 2017-11-29
 Post-History: 2005-11-01, 2005-11-05, 2005-11-07, 2005-12-11, 2005-12-13,
               2005-12-18, 2006-01-05, 2006-03-02, 2006-03-06, 2006-06-12,
               2006-09-05, 2016-03-10, 2017-11-27
@@ -192,9 +192,9 @@ news item's identifier.
 The directory will contain a file named ``yyyy-mm-dd-short-name.en.txt``, which
 contains the text of the news item, in English, in the format described below.
 
-If a news item is translated, other files named ``yyyy-mm-dd-short-name.xx.txt``
-(where ``xx`` is a valid IETF language tag [#bcp-47]_, and the date remains
-the same as the original news item) will also be provided. However, only
+Any translations of a news item will be provided in additional files. Their
+name ``yyyy-mm-dd-short-name.lang.txt`` is obtained from the original filename
+by replacing ``en`` with another IETF language tag [#bcp-47]_. However, only
 the English version of a news item is authoritative.  This anglocentricity is
 justified by precedent [#glep-34]_.