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>
