Gentoo Archives: gentoo-dev

From: Tim Harder <radhermit@g.o>
To: gentoo-dev@l.g.o
Subject: [gentoo-dev] tagging deprecated eclasses internally
Date: Thu, 24 Sep 2020 00:06:47
Message-Id: 20200924000637.GA6343@fir
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.
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.
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.
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.
20 Tim
22 [1]:


Subject Author
Re: [gentoo-dev] tagging deprecated eclasses internally Ulrich Mueller <ulm@g.o>