commit:     f599228d19e81efb54e606c52a1562b857d71929
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Fri May 27 10:15:49 2022 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Fri May 27 10:15:49 2022 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=f599228d

ebuild-writing/misc-files/metadata: Update restrict attribute

The description currently says:
"When this attribute is used, other tags with or without the restrict
attribute must be present to cover all the versions of the package.
A tag without the restrict attribute serves as the default."

However, this is not reflected by the specification in GLEP 68.
It appears to have originated from the old DevRel Handbook where it
had been added in 2004:
https://gitweb.gentoo.org/archive/proj/gentoo.git/tree/xml/htdocs/proj/en/devrel/handbook/hb-guide-metadata.xml?id=26d18f5f20f00e538b7af0d5a795008f3426d243#n135

Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>

 ebuild-writing/misc-files/metadata/text.xml | 15 ++++++---------
 1 file changed, 6 insertions(+), 9 deletions(-)

diff --git a/ebuild-writing/misc-files/metadata/text.xml 
b/ebuild-writing/misc-files/metadata/text.xml
index bcc43f4..9c6bd76 100644
--- a/ebuild-writing/misc-files/metadata/text.xml
+++ b/ebuild-writing/misc-files/metadata/text.xml
@@ -285,15 +285,12 @@ There are also some attributes that can be used with 
these tags:
     <c>&lt;stabilize-allarches&gt;</c>, <c>&lt;flag&gt;</c>
   </ti>
   <ti>
-    The restrict attribute allows one to restrict the application of
-    certain tags to certain versions of a package. When this attribute
-    is used, other tags with or without the restrict attribute must be
-    present to cover all the versions of the package. A tag without
-    the restrict attribute serves as the default. The format of the
-    restrict attribute is that of a EAPI=0 package dependency specification
-    (i.e., USE-conditional or slot dependendencies are not allowed).
-    Since <c>&lt;</c> and <c>&gt;</c> are special characters in XML,
-    they must be escaped using <c>&amp;lt;</c> and <c>&amp;gt;</c>.
+    The restrict attribute allows one to restrict the application of certain
+    tags to certain versions of a package. The format of the restrict attribute
+    is that of a EAPI 0 package dependency specification (i.e. USE-conditional
+    or slot dependendencies are not allowed). Since <c>&lt;</c> and <c>&gt;</c>
+    are special characters in XML, they must be escaped using <c>&amp;lt;</c>
+    and <c>&amp;gt;</c>.
   </ti>
 </tr>
 <tr>

Reply via email to