Re: [gentoo-dev] [PATCH] skel.ebuild: Update comments for inherit, SLOT, KEYWORDS.

2017-12-31 Thread M. J. Everitt
On 31/12/17 19:59, Ulrich Mueller wrote:
>
>> +1, but I'm not going to suggest what to replace it with.
> How about one of these examples:
> "eautoreconf function from autotools.eclass"
> "tc-getCC function from toolchain-funcs.eclass"
>
> Ulrich
I second eautoreconf (with mention of eapply_user and/or default) as I
recently mistakenly put it in the wrong phase function  [d'oh, the
n00bness!]

MJE



signature.asc
Description: OpenPGP digital signature


Re: [gentoo-dev] [PATCH] skel.ebuild: Update comments for inherit, SLOT, KEYWORDS.

2017-12-31 Thread Ulrich Mueller
> On Sun, 31 Dec 2017, William Hubbs wrote:

> On Sun, Dec 31, 2017 at 06:44:39PM +0100, Michał Górny wrote:
>> W dniu nie, 31.12.2017 o godzinie 14∶31 +0100, użytkownik Ulrich Müller
>> napisał:
>> > -# that needs the epatch function from eutils.eclass won't work without the
>> > +# that needs the epatch function from epatch.eclass won't work without the
>> >  # following line:
>> > -inherit eutils
>> > +#inherit epatch
>>
>> Well, given that it's EAPI 6 and we do not want to encourage people
>> to use epatch there, I would prefer if we replaced that example
>> with something else. But it's just a wishful thinking here.

> +1, but I'm not going to suggest what to replace it with.

How about one of these examples:
"eautoreconf function from autotools.eclass"
"tc-getCC function from toolchain-funcs.eclass"

Ulrich


pgpf2QU31jaqD.pgp
Description: PGP signature


Re: [gentoo-dev] [PATCH] skel.ebuild: Update comments for inherit, SLOT, KEYWORDS.

2017-12-31 Thread Ulrich Mueller
> On Sun, 31 Dec 2017, Mike Gilbert wrote:

> On Sun, Dec 31, 2017 at 8:31 AM, Ulrich Müller  wrote:
>> +# Do not use KEYWORDS="*".  This is not valid in an ebuild context.

> Portage actually does support KEYWORDS="*". I believe Funtoo uses
> this for arch-agnostic packages.

> Maybe rephrase this as being forbidden by Gentoo policy.

Not only by policy. It is not valid, according to PMS:
https://projects.gentoo.org/pms/6/pms.html#x1-280003.1.7
https://projects.gentoo.org/pms/6/pms.html#x1-710007.3.2

Ulrich


pgpohOdILlq4t.pgp
Description: PGP signature


Re: [gentoo-dev] [PATCH] skel.ebuild: Update comments for inherit, SLOT, KEYWORDS.

2017-12-31 Thread Ulrich Mueller
> On Sun, 31 Dec 2017, Mart Raudsepp wrote:

> On Sun, 2017-12-31 at 14:31 +0100, Ulrich Müller wrote:
>> -# DO NOT USE KEYWORDS="*".  This is deprecated and only for backward
>> -# compatibility reasons.
>> +# Do not use KEYWORDS="*".  This is not valid in an ebuild context.
>>  KEYWORDS="~x86"

> Maybe update to KEYWORDS="~amd64" while here?

Done.


pgp8Ih09mo3kn.pgp
Description: PGP signature


Re: [gentoo-dev] [PATCH] skel.ebuild: Update comments for inherit, SLOT, KEYWORDS.

2017-12-31 Thread William Hubbs
On Sun, Dec 31, 2017 at 08:07:33PM +0100, Pacho Ramos wrote:
> El dom, 31-12-2017 a las 12:12 -0600, William Hubbs escribió:
> > On Sun, Dec 31, 2017 at 06:44:39PM +0100, Michał Górny wrote:
> > > W dniu nie, 31.12.2017 o godzinie 14∶31 +0100, użytkownik Ulrich Müller
> > > napisał:
> > > > epatch() is provided by epatch.eclass now. Also comment the inherit
> > > > line, since not every ebuild will use it.
> > > > 
> > > > Empty SLOT doesn't disable slots, but is outright illegal in all EAPIs.
> > > > Similar for KEYWORDS="*", which isn't "deprecated" but invalid.
> > > > ---
> > > >  skel.ebuild | 9 -
> > > >  1 file changed, 4 insertions(+), 5 deletions(-)
> > > > 
> > > > diff --git a/skel.ebuild b/skel.ebuild
> > > > index 7ac9dfb7d6d8..4c19b1de4cb8 100644
> > > > --- a/skel.ebuild
> > > > +++ b/skel.ebuild
> > > > @@ -13,9 +13,9 @@
> > > >  EAPI=6
> > > >  
> > > >  # inherit lists eclasses to inherit functions from. For example, an
> > > > ebuild
> > > > -# that needs the epatch function from eutils.eclass won't work without
> > > > the
> > > > +# that needs the epatch function from epatch.eclass won't work without
> > > > the
> > > >  # following line:
> > > > -inherit eutils
> > > > +#inherit epatch
> > > 
> > > Well, given that it's EAPI 6 and we do not want to encourage people to
> > > use epatch there, I would prefer if we replaced that example with
> > > something else. But it's just a wishful thinking here.
> > 
> > +1, but I'm not going to suggest what to replace it with.
> > 
> > William
> 
> Why not eapply (and drop inherit then)? :/

Because that isn't the preferred way to apply patches since it requires
you to override src_prepare.

If the example was about how to apply patches, the correct way is to put
them in a PATCHES variable in global scope, but that's not the intent of
the example.

The intent is to show inheriting an eclass.

William


signature.asc
Description: Digital signature


Re: [gentoo-dev] [PATCH] skel.ebuild: Update comments for inherit, SLOT, KEYWORDS.

2017-12-31 Thread Pacho Ramos
El dom, 31-12-2017 a las 12:12 -0600, William Hubbs escribió:
> On Sun, Dec 31, 2017 at 06:44:39PM +0100, Michał Górny wrote:
> > W dniu nie, 31.12.2017 o godzinie 14∶31 +0100, użytkownik Ulrich Müller
> > napisał:
> > > epatch() is provided by epatch.eclass now. Also comment the inherit
> > > line, since not every ebuild will use it.
> > > 
> > > Empty SLOT doesn't disable slots, but is outright illegal in all EAPIs.
> > > Similar for KEYWORDS="*", which isn't "deprecated" but invalid.
> > > ---
> > >  skel.ebuild | 9 -
> > >  1 file changed, 4 insertions(+), 5 deletions(-)
> > > 
> > > diff --git a/skel.ebuild b/skel.ebuild
> > > index 7ac9dfb7d6d8..4c19b1de4cb8 100644
> > > --- a/skel.ebuild
> > > +++ b/skel.ebuild
> > > @@ -13,9 +13,9 @@
> > >  EAPI=6
> > >  
> > >  # inherit lists eclasses to inherit functions from. For example, an
> > > ebuild
> > > -# that needs the epatch function from eutils.eclass won't work without
> > > the
> > > +# that needs the epatch function from epatch.eclass won't work without
> > > the
> > >  # following line:
> > > -inherit eutils
> > > +#inherit epatch
> > 
> > Well, given that it's EAPI 6 and we do not want to encourage people to
> > use epatch there, I would prefer if we replaced that example with
> > something else. But it's just a wishful thinking here.
> 
> +1, but I'm not going to suggest what to replace it with.
> 
> William

Why not eapply (and drop inherit then)? :/



Re: [gentoo-dev] [PATCH] skel.ebuild: Update comments for inherit, SLOT, KEYWORDS.

2017-12-31 Thread William Hubbs
On Sun, Dec 31, 2017 at 06:44:39PM +0100, Michał Górny wrote:
> W dniu nie, 31.12.2017 o godzinie 14∶31 +0100, użytkownik Ulrich Müller
> napisał:
> > epatch() is provided by epatch.eclass now. Also comment the inherit
> > line, since not every ebuild will use it.
> > 
> > Empty SLOT doesn't disable slots, but is outright illegal in all EAPIs.
> > Similar for KEYWORDS="*", which isn't "deprecated" but invalid.
> > ---
> >  skel.ebuild | 9 -
> >  1 file changed, 4 insertions(+), 5 deletions(-)
> > 
> > diff --git a/skel.ebuild b/skel.ebuild
> > index 7ac9dfb7d6d8..4c19b1de4cb8 100644
> > --- a/skel.ebuild
> > +++ b/skel.ebuild
> > @@ -13,9 +13,9 @@
> >  EAPI=6
> >  
> >  # inherit lists eclasses to inherit functions from. For example, an ebuild
> > -# that needs the epatch function from eutils.eclass won't work without the
> > +# that needs the epatch function from epatch.eclass won't work without the
> >  # following line:
> > -inherit eutils
> > +#inherit epatch
> 
> Well, given that it's EAPI 6 and we do not want to encourage people to
> use epatch there, I would prefer if we replaced that example with
> something else. But it's just a wishful thinking here.

+1, but I'm not going to suggest what to replace it with.

William


signature.asc
Description: Digital signature


Re: [gentoo-dev] [PATCH] skel.ebuild: Update comments for inherit, SLOT, KEYWORDS.

2017-12-31 Thread Michał Górny
W dniu nie, 31.12.2017 o godzinie 14∶31 +0100, użytkownik Ulrich Müller
napisał:
> epatch() is provided by epatch.eclass now. Also comment the inherit
> line, since not every ebuild will use it.
> 
> Empty SLOT doesn't disable slots, but is outright illegal in all EAPIs.
> Similar for KEYWORDS="*", which isn't "deprecated" but invalid.
> ---
>  skel.ebuild | 9 -
>  1 file changed, 4 insertions(+), 5 deletions(-)
> 
> diff --git a/skel.ebuild b/skel.ebuild
> index 7ac9dfb7d6d8..4c19b1de4cb8 100644
> --- a/skel.ebuild
> +++ b/skel.ebuild
> @@ -13,9 +13,9 @@
>  EAPI=6
>  
>  # inherit lists eclasses to inherit functions from. For example, an ebuild
> -# that needs the epatch function from eutils.eclass won't work without the
> +# that needs the epatch function from epatch.eclass won't work without the
>  # following line:
> -inherit eutils
> +#inherit epatch

Well, given that it's EAPI 6 and we do not want to encourage people to
use epatch there, I would prefer if we replaced that example with
something else. But it's just a wishful thinking here.

>  #
>  # eclasses tend to list descriptions of how to use their functions properly.
>  # take a look at /usr/portage/eclass/ for more examples.
> @@ -46,7 +46,7 @@ LICENSE=""
>  # of each SLOT and remove everything else.
>  # Note that normal applications should use SLOT="0" if possible, since
>  # there should only be exactly one version installed at a time.
> -# DO NOT USE SLOT=""! This tells Portage to disable SLOTs for this package.
> +# Do not use SLOT="", because the SLOT variable must not be empty.
>  SLOT="0"
>  
>  # Using KEYWORDS, we can record masking information *inside* an ebuild
> @@ -63,8 +63,7 @@ SLOT="0"
>  # For binary packages, use -* and then list the archs the bin package
>  # exists for.  If the package was for an x86 binary package, then
>  # KEYWORDS would be set like this: KEYWORDS="-* x86"
> -# DO NOT USE KEYWORDS="*".  This is deprecated and only for backward
> -# compatibility reasons.
> +# Do not use KEYWORDS="*".  This is not valid in an ebuild context.
>  KEYWORDS="~x86"
>  
>  # Comprehensive list of any and all USE flags leveraged in the ebuild,

LGTM.

-- 
Best regards,
Michał Górny




Re: [gentoo-dev] [PATCH] skel.ebuild: Update comments for inherit, SLOT, KEYWORDS.

2017-12-31 Thread Sergei Trofimovich
On Sun, 31 Dec 2017 14:31:00 +0100
Ulrich Müller  wrote:

> epatch() is provided by epatch.eclass now. Also comment the inherit
> line, since not every ebuild will use it.
> 
> Empty SLOT doesn't disable slots, but is outright illegal in all EAPIs.
> Similar for KEYWORDS="*", which isn't "deprecated" but invalid.
> ---
>  skel.ebuild | 9 -
>  1 file changed, 4 insertions(+), 5 deletions(-)
> 
> diff --git a/skel.ebuild b/skel.ebuild
> index 7ac9dfb7d6d8..4c19b1de4cb8 100644
> --- a/skel.ebuild
> +++ b/skel.ebuild
> @@ -13,9 +13,9 @@
>  EAPI=6
>  
>  # inherit lists eclasses to inherit functions from. For example, an ebuild
> -# that needs the epatch function from eutils.eclass won't work without the
> +# that needs the epatch function from epatch.eclass won't work without the
>  # following line:
> -inherit eutils
> +#inherit epatch
>  #
>  # eclasses tend to list descriptions of how to use their functions properly.
>  # take a look at /usr/portage/eclass/ for more examples.
> @@ -46,7 +46,7 @@ LICENSE=""
>  # of each SLOT and remove everything else.
>  # Note that normal applications should use SLOT="0" if possible, since
>  # there should only be exactly one version installed at a time.
> -# DO NOT USE SLOT=""! This tells Portage to disable SLOTs for this package.
> +# Do not use SLOT="", because the SLOT variable must not be empty.
>  SLOT="0"
>  
>  # Using KEYWORDS, we can record masking information *inside* an ebuild
> @@ -63,8 +63,7 @@ SLOT="0"
>  # For binary packages, use -* and then list the archs the bin package
>  # exists for.  If the package was for an x86 binary package, then
>  # KEYWORDS would be set like this: KEYWORDS="-* x86"
> -# DO NOT USE KEYWORDS="*".  This is deprecated and only for backward
> -# compatibility reasons.
> +# Do not use KEYWORDS="*".  This is not valid in an ebuild context.
>  KEYWORDS="~x86"

Looks good.

-- 

  Sergei


pgpINmTTPQM5M.pgp
Description: Цифровая подпись OpenPGP


Re: [gentoo-dev] [PATCH] skel.ebuild: Update comments for inherit, SLOT, KEYWORDS.

2017-12-31 Thread Mart Raudsepp
On Sun, 2017-12-31 at 14:31 +0100, Ulrich Müller wrote:
> -# DO NOT USE KEYWORDS="*".  This is deprecated and only for backward
> -# compatibility reasons.
> +# Do not use KEYWORDS="*".  This is not valid in an ebuild context.
>  KEYWORDS="~x86"

Maybe update to KEYWORDS="~amd64" while here?




Re: [gentoo-dev] [PATCH] skel.ebuild: Update comments for inherit, SLOT, KEYWORDS.

2017-12-31 Thread Mike Gilbert
On Sun, Dec 31, 2017 at 8:31 AM, Ulrich Müller  wrote:
> @@ -63,8 +63,7 @@ SLOT="0"
>  # For binary packages, use -* and then list the archs the bin package
>  # exists for.  If the package was for an x86 binary package, then
>  # KEYWORDS would be set like this: KEYWORDS="-* x86"
> -# DO NOT USE KEYWORDS="*".  This is deprecated and only for backward
> -# compatibility reasons.
> +# Do not use KEYWORDS="*".  This is not valid in an ebuild context.
>  KEYWORDS="~x86"

Portage actually does support KEYWORDS="*". I believe Funtoo uses this
for arch-agnostic packages.

Maybe rephrase this as being forbidden by Gentoo policy.

The rest of the patch looks ok.



[gentoo-dev] [PATCH] skel.ebuild: Update comments for inherit, SLOT, KEYWORDS.

2017-12-31 Thread Ulrich Müller
epatch() is provided by epatch.eclass now. Also comment the inherit
line, since not every ebuild will use it.

Empty SLOT doesn't disable slots, but is outright illegal in all EAPIs.
Similar for KEYWORDS="*", which isn't "deprecated" but invalid.
---
 skel.ebuild | 9 -
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/skel.ebuild b/skel.ebuild
index 7ac9dfb7d6d8..4c19b1de4cb8 100644
--- a/skel.ebuild
+++ b/skel.ebuild
@@ -13,9 +13,9 @@
 EAPI=6
 
 # inherit lists eclasses to inherit functions from. For example, an ebuild
-# that needs the epatch function from eutils.eclass won't work without the
+# that needs the epatch function from epatch.eclass won't work without the
 # following line:
-inherit eutils
+#inherit epatch
 #
 # eclasses tend to list descriptions of how to use their functions properly.
 # take a look at /usr/portage/eclass/ for more examples.
@@ -46,7 +46,7 @@ LICENSE=""
 # of each SLOT and remove everything else.
 # Note that normal applications should use SLOT="0" if possible, since
 # there should only be exactly one version installed at a time.
-# DO NOT USE SLOT=""! This tells Portage to disable SLOTs for this package.
+# Do not use SLOT="", because the SLOT variable must not be empty.
 SLOT="0"
 
 # Using KEYWORDS, we can record masking information *inside* an ebuild
@@ -63,8 +63,7 @@ SLOT="0"
 # For binary packages, use -* and then list the archs the bin package
 # exists for.  If the package was for an x86 binary package, then
 # KEYWORDS would be set like this: KEYWORDS="-* x86"
-# DO NOT USE KEYWORDS="*".  This is deprecated and only for backward
-# compatibility reasons.
+# Do not use KEYWORDS="*".  This is not valid in an ebuild context.
 KEYWORDS="~x86"
 
 # Comprehensive list of any and all USE flags leveraged in the ebuild,
-- 
2.15.1


pgp_xTapo9jvZ.pgp
Description: PGP signature