Gentoo Archives: gentoo-dev

From: "Göktürk Yüksek" <gokturk@××××××××××.edu>
To: devmanual@g.o
Cc: gentoo-dev@l.g.o
Subject: [gentoo-dev] [PATCH] ebuild-maintenance: information for updating metadata on package move/removal
Date: Wed, 20 Apr 2016 06:45:43
Message-Id: 1461134716-17346-1-git-send-email-gokturk@binghamton.edu
1 The dtd for metadata.xml supports referencing other packages using the
2 <pkg> tag. It also allows package atoms to be specified as part of the
3 "restrict" attribute for various tags. These references should be
4 properly updated/removed upon package moves and removals.
5
6 Reported-by: NP-Hardass <NP-Hardass@g.o>
7 Signed-off-by: Göktürk Yüksek <gokturk@××××××××××.edu>
8 ---
9 ebuild-maintenance/text.xml | 19 +++++++++++++++++--
10 1 file changed, 17 insertions(+), 2 deletions(-)
11
12 diff --git a/ebuild-maintenance/text.xml b/ebuild-maintenance/text.xml
13 index 66d736f..7cbe755 100644
14 --- a/ebuild-maintenance/text.xml
15 +++ b/ebuild-maintenance/text.xml
16 @@ -441,8 +441,12 @@ Next is checking the files under <path>profiles/</path> such as
17 <path>profiles/package.mask</path> and update them to reflect the ebuild
18 move. Various eclasses automatically provide some of the dependencies upon
19 inherit, so the files under <path>eclass/</path> should be checked and updated
20 -properly as well. Lastly, the titles of the open bugs related to the package
21 -should be updated.
22 +properly. If the package metadata.xml has tags with <c>restrict</c>
23 +attribute, they should be updated to reflect the move. The
24 +metadata.xml for various packages may contain references to the
25 +package being moved using the <c>&lt;pkg&gt;</c> tag which need to be
26 +updated accordingly as well. Lastly, the titles of the open bugs
27 +related to the package should be updated.
28 </p>
29
30 <p>
31 @@ -467,6 +471,12 @@ Here is an example where the package
32 </li>
33 <li>Check the eclasses that may be referencing the package</li>
34 <li>
35 + Update all the
36 + <uri link="::ebuild-writing/misc-files/metadata">metadata.xml</uri>
37 + files which contain a reference to this package using the
38 + <c>&lt;pkg&gt;</c> tag or the <c>restrict</c> attribute.
39 + </li>
40 + <li>
41 Stage all the changed files using <c>git add</c>. For example: <c>git add
42 profiles/package.mask</c>
43 </li>
44 @@ -554,6 +564,11 @@ When removing packages follow these steps:
45 <li>Wait 30 days (or more)</li>
46 <li>Remove from the git tree unless the reason for removal has been fixed</li>
47 <li>Remove package.mask entry</li>
48 + <li>
49 + Remove the <c>&lt;pkg&gt;</c> tags referencing this package in the
50 + <uri link="::ebuild-writing/misc-files/metadata">metadata.xml</uri>
51 + files of other packages.
52 + </li>
53 <li>Close open bugs as WONTFIX</li>
54 </ol>
55
56 --
57 2.7.3