From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id B2DB4139084 for ; Mon, 11 Dec 2017 07:53:31 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id BCD97E1027; Mon, 11 Dec 2017 07:53:30 +0000 (UTC) Received: from smtp.gentoo.org (dev.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 8E6A4E1027 for ; Mon, 11 Dec 2017 07:53:30 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 176C833C1EB for ; Mon, 11 Dec 2017 07:53:29 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 7C31EAE74 for ; Mon, 11 Dec 2017 07:53:27 +0000 (UTC) From: "Ulrich Müller" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Müller" Message-ID: <1512978656.77321ef5b2aed691a13810aea8c5716b7ad2da16.ulm@gentoo> Subject: [gentoo-commits] data/glep:master commit in: / X-VCS-Repository: data/glep X-VCS-Files: glep-0042.rst X-VCS-Directories: / X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Müller X-VCS-Revision: 77321ef5b2aed691a13810aea8c5716b7ad2da16 X-VCS-Branch: master Date: Mon, 11 Dec 2017 07:53:27 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Archives-Salt: 600664cd-502d-4861-9a1c-c89b8b11f590 X-Archives-Hash: 5f4042370868bb3fb99fb1e2be8663a7 commit: 77321ef5b2aed691a13810aea8c5716b7ad2da16 Author: Ulrich Müller gentoo org> AuthorDate: Sun Nov 26 23:30:49 2017 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Mon Dec 11 07:50:56 2017 +0000 URL: https://gitweb.gentoo.org/data/glep.git/commit/?id=77321ef5 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