Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
View | Details | Raw Unified | Return to bug 341959 | Differences between
and this patch

Collapse All | Expand All

(-)a/eclass-writing/text.xml (-18 / +7 lines)
Lines 88-96 A simple way to verify syntax is <c>bash -n foo.eclass</c>. Link Here
88
<body>
88
<body>
89
89
90
<p>No longer used eclasses may be removed from the tree, but developers must
90
<p>No longer used eclasses may be removed from the tree, but developers must
91
adhere to the following process(developers must follow these rules because
91
adhere to the following process:</p>
92
packages installed with a portage version of less than 2.1.4 would break
93
during uninstallation or upgrades):</p>
94
92
95
<ol>
93
<ol>
96
  <li>
94
  <li>
Lines 98-121 during uninstallation or upgrades):</p> Link Here
98
    eclass.
96
    eclass.
99
  </li>
97
  </li>
100
  <li>
98
  <li>
101
    Send a message to the gentoo-dev and gentoo-dev-announce mailing lists
99
    Send a lastrite message to the gentoo-dev and gentoo-dev-announce
102
    announcing that the eclass you are deprecating is now deprecated.
100
    mailing-lists, announcing that the not-used eclass will be removed in 30
101
    days.
103
  </li>
102
  </li>
104
  <li>
103
  <li>
105
    Add a warning to all installation phases that the eclass is now deprecated,
104
    Add a one line comment to the eclass, saying exactly <c># @DEAD</c> so that
106
    perhaps with a hint at what, if any, eclass replaced the functionality that
105
    the eclass-manpages package will not attempt to document it.
107
    the old eclass provided.
108
  </li>
106
  </li>
109
  <li>
107
  <li>
110
    Remove all functionality related to installation of packages from the eclass.
108
    Wait for the 30-day period to pass, then remove the eclass from the tree.
111
  </li>
112
  <li>
113
    Add a one line comment saying exactly <c># @DEAD</c> so that the
114
    eclass-manpages package will not attempt to document it.
115
  </li>
116
  <li>
117
    After two years have passed since the eclass was deprecated, the eclass may
118
    be removed from the portage tree.
119
  </li>
109
  </li>
120
</ol>
110
</ol>
121
111
122
- 

Return to bug 341959