Gentoo Archives: gentoo-dev

From: Sergei Trofimovich <slyfox@g.o>
To: "Ulrich Müller" <ulm@g.o>
Cc: gentoo-dev@l.g.o
Subject: Re: [gentoo-dev] [PATCH] skel.ebuild: Update comments for inherit, SLOT, KEYWORDS.
Date: Sun, 31 Dec 2017 15:30:06
Message-Id: 20171231152951.3cb8cf3b@sf
In Reply to: [gentoo-dev] [PATCH] skel.ebuild: Update comments for inherit, SLOT, KEYWORDS. by "Ulrich Müller"
1 On Sun, 31 Dec 2017 14:31:00 +0100
2 Ulrich Müller <ulm@g.o> wrote:
3
4 > epatch() is provided by epatch.eclass now. Also comment the inherit
5 > line, since not every ebuild will use it.
6 >
7 > Empty SLOT doesn't disable slots, but is outright illegal in all EAPIs.
8 > Similar for KEYWORDS="*", which isn't "deprecated" but invalid.
9 > ---
10 > skel.ebuild | 9 ++++-----
11 > 1 file changed, 4 insertions(+), 5 deletions(-)
12 >
13 > diff --git a/skel.ebuild b/skel.ebuild
14 > index 7ac9dfb7d6d8..4c19b1de4cb8 100644
15 > --- a/skel.ebuild
16 > +++ b/skel.ebuild
17 > @@ -13,9 +13,9 @@
18 > EAPI=6
19 >
20 > # inherit lists eclasses to inherit functions from. For example, an ebuild
21 > -# that needs the epatch function from eutils.eclass won't work without the
22 > +# that needs the epatch function from epatch.eclass won't work without the
23 > # following line:
24 > -inherit eutils
25 > +#inherit epatch
26 > #
27 > # eclasses tend to list descriptions of how to use their functions properly.
28 > # take a look at /usr/portage/eclass/ for more examples.
29 > @@ -46,7 +46,7 @@ LICENSE=""
30 > # of each SLOT and remove everything else.
31 > # Note that normal applications should use SLOT="0" if possible, since
32 > # there should only be exactly one version installed at a time.
33 > -# DO NOT USE SLOT=""! This tells Portage to disable SLOTs for this package.
34 > +# Do not use SLOT="", because the SLOT variable must not be empty.
35 > SLOT="0"
36 >
37 > # Using KEYWORDS, we can record masking information *inside* an ebuild
38 > @@ -63,8 +63,7 @@ SLOT="0"
39 > # For binary packages, use -* and then list the archs the bin package
40 > # exists for. If the package was for an x86 binary package, then
41 > # KEYWORDS would be set like this: KEYWORDS="-* x86"
42 > -# DO NOT USE KEYWORDS="*". This is deprecated and only for backward
43 > -# compatibility reasons.
44 > +# Do not use KEYWORDS="*". This is not valid in an ebuild context.
45 > KEYWORDS="~x86"
46
47 Looks good.
48
49 --
50
51 Sergei