[gentoo-commits] proj/devmanual:master commit in: ebuild-writing/file-format/, general-concepts/tree/

[gentoo-commits] proj/devmanual:master commit in: ebuild-writing/file-format/, general-concepts/tree/

[Ulrich Müller]

commit:     b4ed2cc271b3e81049227d9fb25538dfed981fc9
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Fri May 15 08:33:47 2015 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Fri May 15 08:33:47 2015 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=b4ed2cc2

Update ebuild naming rules from PMS.

PMS doesn't allow package names to begin with a hyphen or a plus sign,
and also has some restrictions on how these names can end.

Apply the same rules to leading characters of other files.
This reflects the current status of the portage tree.

 ebuild-writing/file-format/text.xml | 5 +++++
 general-concepts/tree/text.xml      | 2 +-
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/ebuild-writing/file-format/text.xml b/ebuild-writing/file-format/text.xml
index 1e1f59c..6ab22a2 100644
--- a/ebuild-writing/file-format/text.xml
+++ b/ebuild-writing/file-format/text.xml
@@ -33,6 +33,11 @@ happy.
 </note>
 
 <p>
+The name must not begin with a hyphen or a plus sign, and must not end
+in a hyphen followed by anything that could be mistaken for a version.
+</p>
+
+<p>
 The version section is more complicated. It consists of one or more numbers
 separated by full stop (or period, or dot, or decimal point) characters (eg
 <c>1.2.3</c>, <c>20050108</c>). The final number may have a single letter following it

diff --git a/general-concepts/tree/text.xml b/general-concepts/tree/text.xml
index 698d65d..022a1ea 100644
--- a/general-concepts/tree/text.xml
+++ b/general-concepts/tree/text.xml
@@ -81,7 +81,7 @@ Things that do <b>not</b> belong in the tree:
   <li>Non-text files</li>
   <li>Photos of teletubbies</li>
   <li>Files whose name contains characters outside <c>[A-Za-z0-9._+-]</c></li>
-  <li>Files whose name starts with a dot</li>
+  <li>Files whose name starts with a dot, a hyphen, or a plus sign</li>
 </ul>
 
 <p>