* [gentoo-commits] proj/devmanual:master commit in: ebuild-maintenance/removal/
@ 2020-03-07 17:38 Ulrich Müller
0 siblings, 0 replies; 3+ messages in thread
From: Ulrich Müller @ 2020-03-07 17:38 UTC (permalink / raw
To: gentoo-commits
commit: 1fea908ea8ff1c7a951f968660f3e844206be761
Author: Mike Pagano <mpagano <AT> gentoo <DOT> org>
AuthorDate: Sat Mar 7 16:38:31 2020 +0000
Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Sat Mar 7 17:37:38 2020 +0000
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=1fea908e
ebuild-maintenance/removal: Add git sign-off parameter to example.
Closes: https://bugs.gentoo.org/711810
Signed-off-by: Mike Pagano <mpagano <AT> gentoo.org>
[Order of options flipped.]
Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>
ebuild-maintenance/removal/text.xml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/ebuild-maintenance/removal/text.xml b/ebuild-maintenance/removal/text.xml
index 6269e13..1d8da69 100644
--- a/ebuild-maintenance/removal/text.xml
+++ b/ebuild-maintenance/removal/text.xml
@@ -66,7 +66,7 @@ from the tree:
<pre>
# cd dev-qt
# git rm -rf qtphonon
-# git commit --gpg-sign
+# git commit --signoff --gpg-sign
</pre>
<p>
^ permalink raw reply related [flat|nested] 3+ messages in thread
* [gentoo-commits] proj/devmanual:master commit in: ebuild-maintenance/removal/
@ 2021-01-18 11:18 Ulrich Müller
0 siblings, 0 replies; 3+ messages in thread
From: Ulrich Müller @ 2021-01-18 11:18 UTC (permalink / raw
To: gentoo-commits
commit: f28b85f069c70538c618a3cedece77a359601dd8
Author: Michał Górny <mgorny <AT> gentoo <DOT> org>
AuthorDate: Wed Aug 12 19:36:27 2020 +0000
Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Mon Jan 18 11:17:14 2021 +0000
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=f28b85f0
ebuild-maintenance/removal: Process for virtual removal
Signed-off-by: Michał Górny <mgorny <AT> gentoo.org>
Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>
ebuild-maintenance/removal/text.xml | 43 +++++++++++++++++++++++++++++++++++++
1 file changed, 43 insertions(+)
diff --git a/ebuild-maintenance/removal/text.xml b/ebuild-maintenance/removal/text.xml
index eabbdaf..8fb9f50 100644
--- a/ebuild-maintenance/removal/text.xml
+++ b/ebuild-maintenance/removal/text.xml
@@ -83,6 +83,49 @@ Date: Tue Oct 3 21:43:03 2017 +1100
Closes: https://bugs.gentoo.org/629144
</pre>
+</body>
+</section>
+
+<section>
+<title>Removing a virtual package</title>
+<body>
+
+<p>
+Virtual packages are generally removed when they have no more than one
+provider left. The removal is preceded by updating the remaining ebuilds
+not to use the virtual. Since virtuals do not install any files, there
+is little value in proactively forcing them to be uninstalled from user
+systems or unnecessarily informing the user about the fact. Therefore,
+an alternative removal process is recommended.
+</p>
+
+<p>
+In order to remove a virtual package, follow the following procedure:
+</p>
+
+<ol>
+ <li>
+ If the virtual is being removed along with any of its providers,
+ include the virtual in the last-rites mail. However, please
+ do not include it in the <c>package.mask</c> entry as users do not need
+ to be forced to proactively unmerge it. Instead, add it
+ to <c>package.deprecated</c> to warn developers not to depend on it.
+ Wait the time appropriate for the last rites.
+ </li>
+ <li>
+ Update all ebuilds not to reference the virtual. Since there is
+ no urgent need to remove the virtual from user systems
+ and the resulting rebuilds would be unnecessary, do not bump ebuilds
+ when replacing the dependency.
+ </li>
+ <li>
+ Remove the package directly
+ </li>
+ <li>
+ Perform the post-removal cleanup, as with regular packages
+ </li>
+</ol>
+
</body>
</section>
</chapter>
^ permalink raw reply related [flat|nested] 3+ messages in thread
* [gentoo-commits] proj/devmanual:master commit in: ebuild-maintenance/removal/
@ 2024-05-08 12:10 Michał Górny
0 siblings, 0 replies; 3+ messages in thread
From: Michał Górny @ 2024-05-08 12:10 UTC (permalink / raw
To: gentoo-commits
commit: 885c63e2d3e414024d09a549b77352067ff9fe05
Author: Michał Górny <mgorny <AT> gentoo <DOT> org>
AuthorDate: Wed May 8 09:49:37 2024 +0000
Commit: Michał Górny <mgorny <AT> gentoo <DOT> org>
CommitDate: Wed May 8 09:49:37 2024 +0000
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=885c63e2
ebuild-maintenance/removal: Use the new PKGREMOVED resolution
Signed-off-by: Michał Górny <mgorny <AT> gentoo.org>
ebuild-maintenance/removal/text.xml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/ebuild-maintenance/removal/text.xml b/ebuild-maintenance/removal/text.xml
index ebab645..f012528 100644
--- a/ebuild-maintenance/removal/text.xml
+++ b/ebuild-maintenance/removal/text.xml
@@ -55,7 +55,7 @@ When removing packages follow these steps:
<uri link="::ebuild-writing/misc-files/metadata/">metadata.xml</uri>
files of other packages.
</li>
- <li>Close open bugs as WONTFIX</li>
+ <li>Close open bugs as PKGREMOVED</li>
</ol>
<p>
^ permalink raw reply related [flat|nested] 3+ messages in thread
end of thread, other threads:[~2024-05-08 12:10 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2020-03-07 17:38 [gentoo-commits] proj/devmanual:master commit in: ebuild-maintenance/removal/ Ulrich Müller
-- strict thread matches above, loose matches on Subject: below --
2021-01-18 11:18 Ulrich Müller
2024-05-08 12:10 Michał Górny
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox