summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMichał Górny <mgorny@gentoo.org>2017-04-28 15:49:14 +0200
committerMichał Górny <mgorny@gentoo.org>2017-11-17 17:49:21 +0100
commit900365947d030667731279e7978c3457d847fb5a (patch)
tree15b11066ff31e3df4a2d1d5c86310e753d3e491c /app-portage/eclass-manpages
parentapp-text/paperwork: 1.2.2 bump (diff)
downloadgentoo-900365947d030667731279e7978c3457d847fb5a.tar.gz
gentoo-900365947d030667731279e7978c3457d847fb5a.tar.bz2
gentoo-900365947d030667731279e7978c3457d847fb5a.zip
app-portage/eclass-manpages: Add @SUPPORTED_EAPIS tag for eclass
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.
Diffstat (limited to 'app-portage/eclass-manpages')
-rw-r--r--app-portage/eclass-manpages/files/eclass-to-manpage.awk4
1 files changed, 4 insertions, 0 deletions
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>
# @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:")