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 4F4A2138351 for ; Thu, 23 Jan 2020 07:49:53 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 11A94E0814; Thu, 23 Jan 2020 07:49:52 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (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 BB3E6E0814 for ; Thu, 23 Jan 2020 07:49:51 +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 1995C34E3D0 for ; Thu, 23 Jan 2020 07:49:50 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id C7555101 for ; Thu, 23 Jan 2020 07:49:48 +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: <1579765686.4e0dc9321c17dda46d81bebce8c757b35dfb29e9.ulm@gentoo> Subject: [gentoo-commits] proj/devmanual:master commit in: ebuild-maintenance/removal/, ebuild-maintenance/maintenance-tasks/, ... X-VCS-Repository: proj/devmanual X-VCS-Files: ebuild-maintenance/maintenance-tasks/text.xml ebuild-maintenance/removal/text.xml ebuild-maintenance/text.xml X-VCS-Directories: ebuild-maintenance/ ebuild-maintenance/maintenance-tasks/ ebuild-maintenance/removal/ X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Müller X-VCS-Revision: 4e0dc9321c17dda46d81bebce8c757b35dfb29e9 X-VCS-Branch: master Date: Thu, 23 Jan 2020 07:49:48 +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: 3873160e-4f3b-4fbb-b564-8f122b6f6167 X-Archives-Hash: d339c105c732df69199e290f89110064 commit: 4e0dc9321c17dda46d81bebce8c757b35dfb29e9 Author: Ulrich Müller gentoo org> AuthorDate: Tue Jan 21 10:52:47 2020 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Thu Jan 23 07:48:06 2020 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=4e0dc932 ebuild-maintenance/removal: New chapter. Split off from ebuild-maintenance/maintenance-tasks. Signed-off-by: Ulrich Müller gentoo.org> ebuild-maintenance/maintenance-tasks/text.xml | 83 ------------------------- ebuild-maintenance/removal/text.xml | 89 +++++++++++++++++++++++++++ ebuild-maintenance/text.xml | 1 + 3 files changed, 90 insertions(+), 83 deletions(-) diff --git a/ebuild-maintenance/maintenance-tasks/text.xml b/ebuild-maintenance/maintenance-tasks/text.xml index f4e421a..8a2c3fc 100644 --- a/ebuild-maintenance/maintenance-tasks/text.xml +++ b/ebuild-maintenance/maintenance-tasks/text.xml @@ -11,89 +11,6 @@ developers may not be familiar with.

-
-Removing ebuilds - - -

-When removing an ebuild make sure that no dependencies in Portage are broken -due to the removal additionally, your git commit message should explain -clearly why the ebuild is being removed from the git repository. -

- -

-If you need to remove ebuilds, make sure you do not accidentally remove -the newest/only stable ebuild for any architecture. If you would like to -get a newer version marked stable, then please file a bug or ask on IRC. -

- -

-You should also not cause an unnecessary downgrade for any "~arch" -when removing ebuilds instead, it is best to get the newest version -marked "~arch" first and then remove redundant versions of the ebuild. -

- - -
- -
-Removing a package - - -

-When removing packages follow these steps: -

- -
    -
  1. - Make sure that no dependencies in the Gentoo repository are broken due to - the removal -
    2. -
  2. Send last rites to gentoo-dev-announce and gentoo-dev
    3. -
  3. Mask the package
    4. -
  4. Wait 30 days (or more)
    5. -
  5. Remove from the git tree unless the reason for removal has been fixed
    6. -
  6. - Remove any references to the package from other ebuilds, e.g., - use-conditional dependencies. Blockers are the only exception to this. -
    7. -
  7. Remove package.mask and any package.use.mask entries
    8. -
  8. - Remove the <pkg> tags referencing this package in the - metadata.xml - files of other packages. -
    9. -
  9. Close open bugs as WONTFIX
    10. -
- -

-Here is a list of commands that will delete dev-util/pmk -from the tree: -

- -
-# cd dev-qt
-# git rm -rf qtphonon
-# git commit --gpg-sign
-
- -

-An example commit message is shown below: -

- -
-commit b97eb6d43f45dfd5b739638928db22d3f3392685
-Author: Michael Palimaka <kensington@gentoo.org>
-Date:   Tue Oct 3 21:43:03 2017 +1100
-
-  dev-qt/qtphonon: remove last rited package
-
-  Closes: https://bugs.gentoo.org/629144
-
- - -
-
Conflicting files diff --git a/ebuild-maintenance/removal/text.xml b/ebuild-maintenance/removal/text.xml new file mode 100644 index 0000000..6269e13 --- /dev/null +++ b/ebuild-maintenance/removal/text.xml @@ -0,0 +1,89 @@ + + + +Removing Ebuilds and Packages + +
+Removing ebuilds + + +

+When removing an ebuild make sure that no dependencies in Portage are broken +due to the removal additionally, your git commit message should explain +clearly why the ebuild is being removed from the git repository. +

+ +

+If you need to remove ebuilds, make sure you do not accidentally remove +the newest/only stable ebuild for any architecture. If you would like to +get a newer version marked stable, then please file a bug or ask on IRC. +

+ +

+You should also not cause an unnecessary downgrade for any "~arch" +when removing ebuilds instead, it is best to get the newest version +marked "~arch" first and then remove redundant versions of the ebuild. +

+ + +
+ +
+Removing a package + + +

+When removing packages follow these steps: +

+ +
    +
  1. + Make sure that no dependencies in the Gentoo repository are broken due to + the removal +
    2. +
  2. Send last rites to gentoo-dev-announce and gentoo-dev
    3. +
  3. Mask the package
    4. +
  4. Wait 30 days (or more)
    5. +
  5. Remove from the git tree unless the reason for removal has been fixed
    6. +
  6. + Remove any references to the package from other ebuilds, e.g., + use-conditional dependencies. Blockers are the only exception to this. +
    7. +
  7. Remove package.mask and any package.use.mask entries
    8. +
  8. + Remove the <pkg> tags referencing this package in the + metadata.xml + files of other packages. +
    9. +
  9. Close open bugs as WONTFIX
    10. +
+ +

+Here is a list of commands that will delete dev-util/pmk +from the tree: +

+ +
+# cd dev-qt
+# git rm -rf qtphonon
+# git commit --gpg-sign
+
+ +

+An example commit message is shown below: +

+ +
+commit b97eb6d43f45dfd5b739638928db22d3f3392685
+Author: Michael Palimaka <kensington@gentoo.org>
+Date:   Tue Oct 3 21:43:03 2017 +1100
+
+  dev-qt/qtphonon: remove last rited package
+
+  Closes: https://bugs.gentoo.org/629144
+
+ + +
+ + diff --git a/ebuild-maintenance/text.xml b/ebuild-maintenance/text.xml index 49a7fe1..b298807 100644 --- a/ebuild-maintenance/text.xml +++ b/ebuild-maintenance/text.xml @@ -20,6 +20,7 @@ This section covers various tasks related to working with ebuilds. +