Gentoo Archives: gentoo-dev

From: Duncan <1i5t5.duncan@×××.net>
To: gentoo-dev@l.g.o
Subject: [gentoo-dev] Re: [PATCH 2/2] glep-0042: Update and clarify naming rules.
Date: Mon, 27 Nov 2017 10:54:52
Message-Id: pan$932e4$685ace98$49f0ca02$52a8fbd1@cox.net
In Reply to: [gentoo-dev] [PATCH 2/2] glep-0042: Update and clarify naming rules. by "Ulrich Müller"
1 Ulrich Müller posted on Mon, 27 Nov 2017 00:30:49 +0100 as excerpted:
2
3 > diff --git a/glep-0042.rst b/glep-0042.rst
4 > index 7726ea4..90ae0b2 100644
5 > --- a/glep-0042.rst
6 > +++ b/glep-0042.rst
7 > @@ -179,7 +179,9 @@ form ``yyyy-mm-dd-short-name``, where ``yyyy`` is the year (e.g. ``2005``),
8 > ``mm`` is the month (``01`` through ``12``) and dd is the day of the month
9 > (``01`` through ``31``). The ``short-name`` is a very short name describing the
10 > news item (e.g. ``yoursql-updates``), consisting only of the characters ``a-z``,
11 > -``0-9``, ``+`` (plus), ``-`` (hyphen) and ``_`` (underscore).
12 > +``0-9``, ``+`` (plus), ``-`` (hyphen) and ``_`` (underscore). While there
13 > +is no hard restriction for the length of ``short-name``, it is strongly
14 > +recommended to limit it to at most 20 characters.
15
16 Arguably bikeshedding but changing up the last sentence to read a bit smoother
17 (I skipped formatting)...
18
19 While there is no hard restriction on the length of short-name,
20 limiting it to 20 characters is strongly recommended.
21
22 (s/for/on/, reversing order of the limit and strongly recommended.)
23
24 --
25 Duncan - List replies preferred. No HTML msgs.
26 "Every nonfree program has a lord, a master --
27 and if you use the program, he is your master." Richard Stallman

Replies