From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 140DF1382C5 for ; Mon, 18 Jan 2021 11:18:04 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 39E7FE0843; Mon, 18 Jan 2021 11:18:03 +0000 (UTC) Received: from smtp.gentoo.org (mail.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 1B6F9E0843 for ; Mon, 18 Jan 2021 11:18:02 +0000 (UTC) Received: from oystercatcher.gentoo.org (unknown [IPv6:2a01:4f8:202:4333:225:90ff:fed9:fc84]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id CFD8534092D for ; Mon, 18 Jan 2021 11:18:01 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 50BEF92 for ; Mon, 18 Jan 2021 11:18:00 +0000 (UTC) From: "Ulrich Müller" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Müller" Message-ID: <1610968634.f28b85f069c70538c618a3cedece77a359601dd8.ulm@gentoo> Subject: [gentoo-commits] proj/devmanual:master commit in: ebuild-maintenance/removal/ X-VCS-Repository: proj/devmanual X-VCS-Files: ebuild-maintenance/removal/text.xml X-VCS-Directories: ebuild-maintenance/removal/ X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Müller X-VCS-Revision: f28b85f069c70538c618a3cedece77a359601dd8 X-VCS-Branch: master Date: Mon, 18 Jan 2021 11:18:00 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply X-Archives-Salt: e430a731-828b-46bd-911d-8db5e68bc58c X-Archives-Hash: d0147707a5e429942ac566a6e2db9294 commit: f28b85f069c70538c618a3cedece77a359601dd8 Author: Michał Górny gentoo org> AuthorDate: Wed Aug 12 19:36:27 2020 +0000 Commit: Ulrich Müller gentoo 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 gentoo.org> Signed-off-by: Ulrich Müller 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 + + + +
+Removing a virtual package + + +

+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. +

+ +

+In order to remove a virtual package, follow the following procedure: +

+ +
    +
  1. + 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 package.mask entry as users do not need + to be forced to proactively unmerge it. Instead, add it + to package.deprecated to warn developers not to depend on it. + Wait the time appropriate for the last rites. +
    2. +
  2. + 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. +
    3. +
  3. + Remove the package directly +
    4. +
  4. + Perform the post-removal cleanup, as with regular packages +
    5. +
+