On pią, 2017-04-28 at 16:06 +0200, Michał Górny wrote: > Add a @SUPPORTED_EAPIS tag that can be used to explicitly provide a list > of EAPIs that are supported by the eclass. The main goal is to make it > possible to extract this list with relative ease, for scripting > purposes. It is not included explicitly in the manpages at the moment. > > The first use case is to make it possible to explicitly distinguish > eclasses that do not support a specific EAPI from eclasses that are not > used by any ebuilds using a specific EAPI. Therefore, it will make it > possible to easily detect when we can deprecate old EAPIs from eclasses. > --- > app-portage/eclass-manpages/files/eclass-to-manpage.awk | 4 ++++ > 1 file changed, 4 insertions(+) > > diff --git a/app-portage/eclass-manpages/files/eclass-to-manpage.awk > b/app-portage/eclass-manpages/files/eclass-to-manpage.awk > index 0b65162c04ec..fe7e9c12d8f5 100644 > --- a/app-portage/eclass-manpages/files/eclass-to-manpage.awk > +++ b/app-portage/eclass-manpages/files/eclass-to-manpage.awk > @@ -18,6 +18,7 @@ > # <optional; description of how to report bugs; > # default: tell people to use bugs.gentoo.org> > # @VCSURL: <optional; url to vcs for this eclass; default: > https://gitweb.gentoo.org/repo/gentoo.git/log/eclass/@ECLASS@>; > +# @SUPPORTED_EAPIS: <optional; space-separated list of EAPIs>
Hmm, I'm going to resubmit this with '-' instead of '_'. The doc format
doesn't use either consistently, so there's really no point trying to
follow the worse option.
> # @BLURB: <required; short description>
> # @DESCRIPTION:
> # <optional; long description>
> @@ -147,6 +148,7 @@ function handle_eclass() {
> eclass = $3
> eclass_maintainer = ""
> eclass_author = ""
> + supported_eapis = ""
> blurb = ""
> desc = ""
> example = ""
> @@ -176,6 +178,8 @@ function handle_eclass() {
> reporting_bugs = eat_paragraph()
> if ($2 == "@VCSURL:")
> vcs_url = eat_line()
> + if ($2 == "@SUPPORTED_EAPIS:")
> + supported_eapis = eat_line()
> if ($2 == "@BLURB:")
> blurb = eat_line()
> if ($2 == "@DESCRIPTION:")
--
Best regards,
Michał Górny
signature.asc
Description: This is a digitally signed message part
