Lines 1-4
Link Here
|
1 |
<?xml version="1.0"?> |
1 |
?xml version="1.0"?> |
2 |
<guide self="eclass-writing/"> |
2 |
<guide self="eclass-writing/"> |
3 |
<chapter> |
3 |
<chapter> |
4 |
<title>Eclass Writing Guide</title> |
4 |
<title>Eclass Writing Guide</title> |
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 |
- |
|
|