In short, pkgcheck (in git) now supports parsing the eclass doc format
as specified at [1] for the gentoo repo. This enables extracting more
info from various eclass doc annotations.

Along those lines, pkgcheck recognizes the '@DEPRECATED:' tag for all
eclass doc block types. At the global level, this allows deprecated
eclasses to internally document their status inside the '@ECLASS:'
block, note their replacement (if any), and add further information if
necessary.  

This allows for the hardcoded and poorly maintained eclass deprecation
list in pkgcheck to be replaced by a dynamic version pulled from its
eclass cache.

If no one objects, I'd like to replace the deprecated-eclass section in
metadata/qa-policy.conf with individual '@DEPRECATED:' annotations for
the listed eclasses as well as adding info about the tag to the
devmanual.

Tim

[1]: https://devmanual.gentoo.org/eclass-writing/#documenting-eclasses

Reply via email to