| 1 |
commit: d554af92dac47eb78c4fd1f62c00fd8c2e0c7c2b |
| 2 |
Author: Ulrich Müller <ulm <AT> gentoo <DOT> org> |
| 3 |
AuthorDate: Sun Nov 26 23:30:49 2017 +0000 |
| 4 |
Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org> |
| 5 |
CommitDate: Mon Nov 27 09:36:58 2017 +0000 |
| 6 |
URL: https://gitweb.gentoo.org/data/glep.git/commit/?id=d554af92 |
| 7 |
|
| 8 |
glep-0042: Update and clarify naming rules. |
| 9 |
|
| 10 |
Update the GLEP from ISO 639 to IETF language tags (BCP 47), in order |
| 11 |
to make it consistent with usage in the L10N USE_EXPAND variable. |
| 12 |
This will make no difference for most common languages. Also there are |
| 13 |
currently no translations of news items at all. |
| 14 |
|
| 15 |
Add a note clarifying what "very short" means. |
| 16 |
|
| 17 |
glep-0042.rst | 11 +++++++---- |
| 18 |
1 file changed, 7 insertions(+), 4 deletions(-) |
| 19 |
|
| 20 |
diff --git a/glep-0042.rst b/glep-0042.rst |
| 21 |
index 7726ea4..90ae0b2 100644 |
| 22 |
--- a/glep-0042.rst |
| 23 |
+++ b/glep-0042.rst |
| 24 |
@@ -179,7 +179,9 @@ form ``yyyy-mm-dd-short-name``, where ``yyyy`` is the year (e.g. ``2005``), |
| 25 |
``mm`` is the month (``01`` through ``12``) and dd is the day of the month |
| 26 |
(``01`` through ``31``). The ``short-name`` is a very short name describing the |
| 27 |
news item (e.g. ``yoursql-updates``), consisting only of the characters ``a-z``, |
| 28 |
-``0-9``, ``+`` (plus), ``-`` (hyphen) and ``_`` (underscore). |
| 29 |
+``0-9``, ``+`` (plus), ``-`` (hyphen) and ``_`` (underscore). While there |
| 30 |
+is no hard restriction for the length of ``short-name``, it is strongly |
| 31 |
+recommended to limit it to at most 20 characters. |
| 32 |
|
| 33 |
News Item Directories |
| 34 |
--------------------- |
| 35 |
@@ -191,8 +193,8 @@ The directory will contain a file named ``yyyy-mm-dd-short-name.en.txt``, which |
| 36 |
contains the text of the news item, in English, in the format described below. |
| 37 |
|
| 38 |
If a news item is translated, other files named ``yyyy-mm-dd-short-name.xx.txt`` |
| 39 |
-(where ``xx`` is the ISO 639 [#iso-639]_ two letter language code, and the date |
| 40 |
-remains the same as the original news item) will also be provided. However, only |
| 41 |
+(where ``xx`` is a valid IETF language tag [#bcp-47]_, and the date remains |
| 42 |
+the same as the original news item) will also be provided. However, only |
| 43 |
the English version of a news item is authoritative. This anglocentricity is |
| 44 |
justified by precedent [#glep-34]_. |
| 45 |
|
| 46 |
@@ -475,6 +477,8 @@ Example Files |
| 47 |
References |
| 48 |
========== |
| 49 |
|
| 50 |
+.. [#bcp-47] BCP 47: "Tags for identifying languages", |
| 51 |
+ https://tools.ietf.org/rfc/bcp/bcp47.txt |
| 52 |
.. [#bug-11359] Bugzilla Bug 11359 |
| 53 |
"[NEW FEATURE] pkg_postinst/pkg_preinst ewarn/einfo logging", |
| 54 |
https://bugs.gentoo.org/show_bug.cgi?id=11359 |
| 55 |
@@ -500,7 +504,6 @@ References |
| 56 |
.. [#glep-74] GLEP 74: "Full-tree verification using Manifest files", |
| 57 |
Michał Górny, Robin Hugh Johnson, Ulrich Müller, |
| 58 |
https://www.gentoo.org/glep/glep-0074.html |
| 59 |
-.. [#iso-639] ISO 639 "Code for the representation of names of languages" |
| 60 |
.. [#ramereth-repo] "Re: [gentoo-dev] GLEP ??: Critical News Reporting", Lance |
| 61 |
Albertson, |
| 62 |
https://archives.gentoo.org/gentoo-dev/message/4204839d4091758c3bad1dbd18ed16f7 |
Archives