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