aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGöktürk Yüksek <gokturk@binghamton.edu>2016-04-20 02:45:16 -0400
committerGöktürk Yüksek <gokturk@binghamton.edu>2016-04-23 20:21:39 -0400
commit41ede153d18e712ea0686f23f3571d2e444f1b5f (patch)
tree1bc6bfd708ef0a714532b1753b0c7b9738ebd15b /ebuild-maintenance
parentebuild-maintenance: remove the mention of ChangeLog (diff)
downloaddevmanual-41ede153d18e712ea0686f23f3571d2e444f1b5f.tar.gz
devmanual-41ede153d18e712ea0686f23f3571d2e444f1b5f.tar.bz2
devmanual-41ede153d18e712ea0686f23f3571d2e444f1b5f.zip
ebuild-maintenance: information for updating metadata on package move/removal
Per GLEP 68, metadata.xml supports referencing other packages using the <pkg> tag. It also allows package atoms to be specified as part of the "restrict" attribute for various tags. These references should be properly updated/removed upon package moves and removals. Reported-by: NP-Hardass <NP-Hardass@gentoo.org> Signed-off-by: Göktürk Yüksek <gokturk@binghamton.edu>
Diffstat (limited to 'ebuild-maintenance')
-rw-r--r--ebuild-maintenance/text.xml19
1 files changed, 17 insertions, 2 deletions
diff --git a/ebuild-maintenance/text.xml b/ebuild-maintenance/text.xml
index 66d736f..7cbe755 100644
--- a/ebuild-maintenance/text.xml
+++ b/ebuild-maintenance/text.xml
@@ -441,8 +441,12 @@ Next is checking the files under <path>profiles/</path> such as
<path>profiles/package.mask</path> and update them to reflect the ebuild
move. Various eclasses automatically provide some of the dependencies upon
inherit, so the files under <path>eclass/</path> should be checked and updated
-properly as well. Lastly, the titles of the open bugs related to the package
-should be updated.
+properly. If the package metadata.xml has tags with <c>restrict</c>
+attribute, they should be updated to reflect the move. The
+metadata.xml for various packages may contain references to the
+package being moved using the <c>&lt;pkg&gt;</c> tag which need to be
+updated accordingly as well. Lastly, the titles of the open bugs
+related to the package should be updated.
</p>
<p>
@@ -467,6 +471,12 @@ Here is an example where the package
</li>
<li>Check the eclasses that may be referencing the package</li>
<li>
+ Update all the
+ <uri link="::ebuild-writing/misc-files/metadata">metadata.xml</uri>
+ files which contain a reference to this package using the
+ <c>&lt;pkg&gt;</c> tag or the <c>restrict</c> attribute.
+ </li>
+ <li>
Stage all the changed files using <c>git add</c>. For example: <c>git add
profiles/package.mask</c>
</li>
@@ -554,6 +564,11 @@ When removing packages follow these steps:
<li>Wait 30 days (or more)</li>
<li>Remove from the git tree unless the reason for removal has been fixed</li>
<li>Remove package.mask entry</li>
+ <li>
+ Remove the <c>&lt;pkg&gt;</c> tags referencing this package in the
+ <uri link="::ebuild-writing/misc-files/metadata">metadata.xml</uri>
+ files of other packages.
+ </li>
<li>Close open bugs as WONTFIX</li>
</ol>