From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 9398F139694 for ; Wed, 3 May 2017 21:34:42 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id D152AE0C44; Wed, 3 May 2017 21:34:31 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 78610E0C17 for ; Wed, 3 May 2017 21:34:31 +0000 (UTC) Received: from [46.246.40.190] (anon-40-190.vpn.ipredator.se [46.246.40.190]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) (Authenticated sender: zlg) by smtp.gentoo.org (Postfix) with ESMTPSA id D954A3416C5 for ; Wed, 3 May 2017 21:34:29 +0000 (UTC) Subject: Re: [gentoo-dev] [PATCH 1/2] app-portage/eclass-manpages: Add @SUPPORTED_EAPIS tag for eclass To: gentoo-dev@lists.gentoo.org References: <20170428140604.2264-1-mgorny@gentoo.org> From: Daniel Campbell Message-ID: Date: Wed, 3 May 2017 14:34:23 -0700 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101 Thunderbird/45.8.0 Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@lists.gentoo.org Reply-to: gentoo-dev@lists.gentoo.org MIME-Version: 1.0 In-Reply-To: <20170428140604.2264-1-mgorny@gentoo.org> Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="NQlWJiA1jp1VVf2Vw6GdbaHdtWFrhEvWH" X-Archives-Salt: a9b05072-32db-49d7-95a8-26172c39a318 X-Archives-Hash: 62e8f4dbeddb4385e32788589f12d92b This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --NQlWJiA1jp1VVf2Vw6GdbaHdtWFrhEvWH Content-Type: multipart/mixed; boundary="GVVeRd0jW913I0wapNjqK3wqmsWaXHLAR"; protected-headers="v1" From: Daniel Campbell To: gentoo-dev@lists.gentoo.org Message-ID: Subject: Re: [gentoo-dev] [PATCH 1/2] app-portage/eclass-manpages: Add @SUPPORTED_EAPIS tag for eclass References: <20170428140604.2264-1-mgorny@gentoo.org> In-Reply-To: <20170428140604.2264-1-mgorny@gentoo.org> --GVVeRd0jW913I0wapNjqK3wqmsWaXHLAR Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable On 04/28/2017 07:06 AM, Micha=C5=82 G=C3=B3rny wrote: > Add a @SUPPORTED_EAPIS tag that can be used to explicitly provide a lis= t > 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. >=20 > 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= =2E > --- > app-portage/eclass-manpages/files/eclass-to-manpage.awk | 4 ++++ > 1 file changed, 4 insertions(+) >=20 > 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 @@ > # # default: tell people to use bugs.gentoo.org> > # @VCSURL: > +# @SUPPORTED_EAPIS: > # @BLURB: > # @DESCRIPTION: > # > @@ -147,6 +148,7 @@ function handle_eclass() { > eclass =3D $3 > eclass_maintainer =3D "" > eclass_author =3D "" > + supported_eapis =3D "" > blurb =3D "" > desc =3D "" > example =3D "" > @@ -176,6 +178,8 @@ function handle_eclass() { > reporting_bugs =3D eat_paragraph() > if ($2 =3D=3D "@VCSURL:") > vcs_url =3D eat_line() > + if ($2 =3D=3D "@SUPPORTED_EAPIS:") > + supported_eapis =3D eat_line() > if ($2 =3D=3D "@BLURB:") > blurb =3D eat_line() > if ($2 =3D=3D "@DESCRIPTION:") >=20 Looks like something eclass developers could really use. I say go for it! I'm not sure what you're talking about regarding _ vs. -; do you mean the variable name? I think _ makes a bit more sense there since we use INSTALL_MASK, PYTHON_SINGLE_TARGET, or other variable names with underscores. Using a hyphen would make it stick out from other similarly structured variable names. --=20 Daniel Campbell - Gentoo Developer OpenPGP Key: 0x1EA055D6 @ hkp://keys.gnupg.net fpr: AE03 9064 AE00 053C 270C 1DE4 6F7A 9091 1EA0 55D6 --GVVeRd0jW913I0wapNjqK3wqmsWaXHLAR-- --NQlWJiA1jp1VVf2Vw6GdbaHdtWFrhEvWH Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAEBCAAdFiEEgIn+0tMDW9PQWDLnASQOlFA54XAFAlkKTOAACgkQASQOlFA5 4XBgzhAAmSOd4DtjLpxJ0QYAp2l3S5vOHYsZMm/msSFGbzwwYvgjvmhRC7GS3lVA Eu5gFsrLf0VF27LTs+2JC6ZLFQ/nM9pbgdBXL5eYNfZtge2uMAJIxloULyZuz1wW c3mUUxuaTRKH2ZZrs6V6G5ZGhxRCRPWuFAC8DqmoDzbuqetn8ccC16TYP/gyDjhG G35ShsVuwhHN1ARhv/Eh3zRlTnhMpoossDxfAGz0MjkjXy95IiBMXfdzxJFaFpX+ FRI3EIavEe/77qTEKJstIFkHh61hSQ5lEpkwtuWfrrpwXrJyezEUmCw4LGrhBurN TYzMtrkdeYbWkYSgFQuOO2LamAn9uyXdvZsHLu9Fkv92bPJvb1yKCF4Hy4HYMi/2 anyhg+W6uwvaIsq9OWePcd+iCvKOJ3kSTEbAzyYapAh2oevHxt5AD255za76rYLb POOqOxduF79vC+O0lm3yDMqzRc3rRndoPiEgiHCfb2SEutyj1YJDN7sSe+uHauHD r8GsQrO0UAlNQfCbRt9aioDon4IvP4V2CZllB8fbPRZzIyDNM7HRQTebrhSaREIU Ia6+7zFMfyAWWrfdSE4vcpMioCfQ+NM4O+Uhr2PgYBg/0rUIAMTC/jAKVTW7K701 VZSqPmCgSYRhK6YbKqgwJlthsekX35myozqOrK3EVoXlYtJ+1qc= =nFaE -----END PGP SIGNATURE----- --NQlWJiA1jp1VVf2Vw6GdbaHdtWFrhEvWH--