| 1 |
In short, pkgcheck (in git) now supports parsing the eclass doc format |
| 2 |
as specified at [1] for the gentoo repo. This enables extracting more |
| 3 |
info from various eclass doc annotations. |
| 4 |
|
| 5 |
Along those lines, pkgcheck recognizes the '@DEPRECATED:' tag for all |
| 6 |
eclass doc block types. At the global level, this allows deprecated |
| 7 |
eclasses to internally document their status inside the '@ECLASS:' |
| 8 |
block, note their replacement (if any), and add further information if |
| 9 |
necessary. |
| 10 |
|
| 11 |
This allows for the hardcoded and poorly maintained eclass deprecation |
| 12 |
list in pkgcheck to be replaced by a dynamic version pulled from its |
| 13 |
eclass cache. |
| 14 |
|
| 15 |
If no one objects, I'd like to replace the deprecated-eclass section in |
| 16 |
metadata/qa-policy.conf with individual '@DEPRECATED:' annotations for |
| 17 |
the listed eclasses as well as adding info about the tag to the |
| 18 |
devmanual. |
| 19 |
|
| 20 |
Tim |
| 21 |
|
| 22 |
[1]: https://devmanual.gentoo.org/eclass-writing/#documenting-eclasses |
Archives