From 7f5d57f58a72d788b5f7fe7c54c21eebad8a55a2 Mon Sep 17 00:00:00 2001 From: wired Date: Fri, 19 Nov 2010 13:23:09 +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 | 24 +++++++----------------- 1 files changed, 7 insertions(+), 17 deletions(-) diff --git a/eclass-writing/text.xml b/eclass-writing/text.xml index 36927ac..e86210e 100644 --- a/eclass-writing/text.xml +++ b/eclass-writing/text.xml @@ -88,9 +88,7 @@ A simple way to verify syntax is bash -n foo.eclass.

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):

+adhere to the following process:

@@ -98,24 +96,16 @@ during uninstallation or upgrades):
eclass.
- 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.
- 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 # @DEAD so that + the eclass-manpages package will not attempt to document it.
- Remove all functionality related to installation of packages from the eclass. -
- Add a one line comment saying exactly # @DEAD so that the - eclass-manpages package will not attempt to document it. -
- 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.

-- 1.7.3.2