| 1 |
commit: 900365947d030667731279e7978c3457d847fb5a |
| 2 |
Author: Michał Górny <mgorny <AT> gentoo <DOT> org> |
| 3 |
AuthorDate: Fri Apr 28 13:49:14 2017 +0000 |
| 4 |
Commit: Michał Górny <mgorny <AT> gentoo <DOT> org> |
| 5 |
CommitDate: Fri Nov 17 16:49:21 2017 +0000 |
| 6 |
URL: https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=90036594 |
| 7 |
|
| 8 |
app-portage/eclass-manpages: Add @SUPPORTED_EAPIS tag for eclass |
| 9 |
|
| 10 |
Add a @SUPPORTED_EAPIS tag that can be used to explicitly provide a list |
| 11 |
of EAPIs that are supported by the eclass. The main goal is to make it |
| 12 |
possible to extract this list with relative ease, for scripting |
| 13 |
purposes. It is not included explicitly in the manpages at the moment. |
| 14 |
|
| 15 |
The first use case is to make it possible to explicitly distinguish |
| 16 |
eclasses that do not support a specific EAPI from eclasses that are not |
| 17 |
used by any ebuilds using a specific EAPI. Therefore, it will make it |
| 18 |
possible to easily detect when we can deprecate old EAPIs from eclasses. |
| 19 |
|
| 20 |
app-portage/eclass-manpages/files/eclass-to-manpage.awk | 4 ++++ |
| 21 |
1 file changed, 4 insertions(+) |
| 22 |
|
| 23 |
diff --git a/app-portage/eclass-manpages/files/eclass-to-manpage.awk b/app-portage/eclass-manpages/files/eclass-to-manpage.awk |
| 24 |
index 0b65162c04e..fe7e9c12d8f 100644 |
| 25 |
--- a/app-portage/eclass-manpages/files/eclass-to-manpage.awk |
| 26 |
+++ b/app-portage/eclass-manpages/files/eclass-to-manpage.awk |
| 27 |
@@ -18,6 +18,7 @@ |
| 28 |
# <optional; description of how to report bugs; |
| 29 |
# default: tell people to use bugs.gentoo.org> |
| 30 |
# @VCSURL: <optional; url to vcs for this eclass; default: https://gitweb.gentoo.org/repo/gentoo.git/log/eclass/@ECLASS@> |
| 31 |
+# @SUPPORTED_EAPIS: <optional; space-separated list of EAPIs> |
| 32 |
# @BLURB: <required; short description> |
| 33 |
# @DESCRIPTION: |
| 34 |
# <optional; long description> |
| 35 |
@@ -147,6 +148,7 @@ function handle_eclass() { |
| 36 |
eclass = $3 |
| 37 |
eclass_maintainer = "" |
| 38 |
eclass_author = "" |
| 39 |
+ supported_eapis = "" |
| 40 |
blurb = "" |
| 41 |
desc = "" |
| 42 |
example = "" |
| 43 |
@@ -176,6 +178,8 @@ function handle_eclass() { |
| 44 |
reporting_bugs = eat_paragraph() |
| 45 |
if ($2 == "@VCSURL:") |
| 46 |
vcs_url = eat_line() |
| 47 |
+ if ($2 == "@SUPPORTED_EAPIS:") |
| 48 |
+ supported_eapis = eat_line() |
| 49 |
if ($2 == "@BLURB:") |
| 50 |
blurb = eat_line() |
| 51 |
if ($2 == "@DESCRIPTION:") |
Archives