Attachment 254813 Details for Bug 341959 – patch for eclass removal

[patch] patch for eclass removal

0001-fix-for-bug-341959.patch (text/plain), 2.46 KB, created by Alex Alexander (RETIRED) on 2010-11-19 11:21:23 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Alex Alexander (RETIRED)

Created: 2010-11-19 11:21:23 UTC

Size: 2.46 KB

patch

obsolete

>From 37645cc998b0f339a30c09af51fe953e2cc77b6e Mon Sep 17 00:00:00 2001
>From: wired <wired@gentoo.org>
>Date: Fri, 19 Nov 2010 13:14:36 +0200
>Subject: [PATCH] fix for bug #341959
>
>note that this tackles the eclass removal case, not eclass deprecation.
>another section should be added above this one, detailing how to
>deprecate an eclass that is currently in use - either because it has a
>replacement, or because its functionality is not useful anymore.
>---
> eclass-writing/text.xml |   26 ++++++++------------------
> 1 files changed, 8 insertions(+), 18 deletions(-)
>
>diff --git a/eclass-writing/text.xml b/eclass-writing/text.xml
>index 36927ac..6c1dd39 100644
>--- a/eclass-writing/text.xml
>+++ b/eclass-writing/text.xml
>@@ -1,4 +1,4 @@
>-<?xml version="1.0"?>
>+?xml version="1.0"?>
> <guide self="eclass-writing/">
> <chapter>
> <title>Eclass Writing Guide</title>
>@@ -88,9 +88,7 @@ A simple way to verify syntax is <c>bash -n foo.eclass</c>.
> <body>
> 
> <p>No longer used eclasses may be removed from the tree, but developers must
>-adhere to the following process(developers must follow these rules because
>-packages installed with a portage version of less than 2.1.4 would break
>-during uninstallation or upgrades):</p>
>+adhere to the following process:</p>
> 
> <ol>
>   <li>
>@@ -98,24 +96,16 @@ during uninstallation or upgrades):</p>
>     eclass.
>   </li>
>   <li>
>-    Send a message to the gentoo-dev and gentoo-dev-announce mailing lists
>-    announcing that the eclass you are deprecating is now deprecated.
>+    Send a lastrite message to the gentoo-dev and gentoo-dev-announce
>+    mailing-lists, announcing that the not-used eclass will be removed in 30
>+    days.
>   </li>
>   <li>
>-    Add a warning to all installation phases that the eclass is now deprecated,
>-    perhaps with a hint at what, if any, eclass replaced the functionality that
>-    the old eclass provided.
>+    Add a one line comment to the eclass, saying exactly <c># @DEAD</c> so that
>+    the eclass-manpages package will not attempt to document it.
>   </li>
>   <li>
>-    Remove all functionality related to installation of packages from the eclass.
>-  </li>
>-  <li>
>-    Add a one line comment saying exactly <c># @DEAD</c> so that the
>-    eclass-manpages package will not attempt to document it.
>-  </li>
>-  <li>
>-    After two years have passed since the eclass was deprecated, the eclass may
>-    be removed from the portage tree.
>+    Wait for the 30-day period to pass, then remove the eclass from the tree.
>   </li>
> </ol>
> 
>-- 
>1.7.3.2
>

Actions: View | Diff

Attachments on bug 341959: 254813 | 254817