[gentoo-dev] Ebuilds for packages without a homepage?

[gentoo-dev] Ebuilds for packages without a homepage?

[Harald van Dijk]

[-- Attachment #1: Type: text/plain, Size: 726 bytes --]

What's the right thing to do with an ebuild's HOMEPAGE variable if there
is not any homepage? Different packages have different approaches for
this; some don't have any HOMEPAGE line (dev-util/cdecl), some set
HOMEPAGE to the empty string (app-i18n/kon2), possibly with a comment
following it (app-i18n/kcc), and some set HOMEPAGE to some string that's
obviously not a URL such as "none" (app-doc/xmltoman) or "I HAVE NO HOME
:(" (app-text/dos2unix). There don't seem to be any guidelines in the
docs, either official or unofficial, other than to put a link to the
freshmeat page or something similar, which isn't possible in my case
because there is no freshmeat page or anything similar that I know of,
so what should I do?

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [gentoo-dev] Ebuilds for packages without a homepage?

[Marco Morales]

[-- Attachment #1: Type: text/plain, Size: 1021 bytes --]

I think "none" could be the better workaround imho.

On Tue, Oct 25, 2005 at 09:12:42AM +0200, Harald van D??k wrote:
> What's the right thing to do with an ebuild's HOMEPAGE variable if there
> is not any homepage? Different packages have different approaches for
> this; some don't have any HOMEPAGE line (dev-util/cdecl), some set
> HOMEPAGE to the empty string (app-i18n/kon2), possibly with a comment
> following it (app-i18n/kcc), and some set HOMEPAGE to some string that's
> obviously not a URL such as "none" (app-doc/xmltoman) or "I HAVE NO HOME
> :(" (app-text/dos2unix). There don't seem to be any guidelines in the
> docs, either official or unofficial, other than to put a link to the
> freshmeat page or something similar, which isn't possible in my case
> because there is no freshmeat page or anything similar that I know of,
> so what should I do?



-- 
Marco Morales <soulse@gentoo.org> 
Gentoo Linux Developer

"Imagination is more important than knowledge."
- Albert Einstein

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [gentoo-dev] Ebuilds for packages without a homepage?

[Krzysiek Pawlik]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Marco Morales wrote:
> I think "none" could be the better workaround imho.

I vote for "none" too :) It clearly states, that HOMEPAGE is missing.
Blank HOMEPAGE is misleading.

- --
Krzysiek 'Nelchael' Pawlik
GPG:0xBC555551
I don't suffer from insanity. I enjoy every minute of it.
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.2 (GNU/Linux)

iD8DBQFDXnrogo/w9rxVVVERAtzPAJwJS022s3li7yQeTzTxTEMlZqRRQwCfTU0y
HMx2CGolYz9FXr2H/RmPGFY=
=OKPF
-----END PGP SIGNATURE-----
-- 
gentoo-dev@gentoo.org mailing list

Re: [gentoo-dev] Ebuilds for packages without a homepage?

[Mike Frysinger]

On Tue, Oct 25, 2005 at 08:35:20PM +0200, Krzysiek Pawlik wrote:
> Marco Morales wrote:
> > I think "none" could be the better workaround imho.
> 
> I vote for "none" too :) It clearly states, that HOMEPAGE is missing.
> Blank HOMEPAGE is misleading.

how can a blank HOMEPAGE be misleading ?
-mike
-- 
gentoo-dev@gentoo.org mailing list

Re: [gentoo-dev] Ebuilds for packages without a homepage?

[Krzysiek Pawlik]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Mike Frysinger wrote:
> how can a blank HOMEPAGE be misleading ?

Page is unknown, too lazy to search, what does empty HOMEPAGE exactly mean?

- --
Krzysiek 'Nelchael' Pawlik
GPG:0xBC555551
Lottery: A tax on people who are bad at math.
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.2 (GNU/Linux)

iD8DBQFDXoWJgo/w9rxVVVERAiS+AJ49naE8YX7AiPYQntVkQMXZ+wN1QwCfUssB
T4fjjCTmHsy169aWxKPthYU=
=63OB
-----END PGP SIGNATURE-----
-- 
gentoo-dev@gentoo.org mailing list

Re: [gentoo-dev] Ebuilds for packages without a homepage?

[Ciaran McCreesh]

[-- Attachment #1: Type: text/plain, Size: 696 bytes --]

On Tue, 25 Oct 2005 21:20:41 +0200 Krzysiek Pawlik
<nelchael@gentoo.org> wrote:
| Mike Frysinger wrote:
| > how can a blank HOMEPAGE be misleading ?
| 
| Page is unknown, too lazy to search, what does empty HOMEPAGE exactly
| mean?

That there is no HOMEPAGE, in the same way that an empty DEPEND means
there are no dependencies, an empty IUSE means there are no used USE
flags and an empty SRC_URI means there are no download components.

For "unknown" or "too lazy" cases, the package shouldn't be in the tree.

-- 
Ciaran McCreesh : Gentoo Developer (Vim, Shell tools, Fluxbox, Cron)
Mail            : ciaranm at gentoo.org
Web             : http://dev.gentoo.org/~ciaranm


[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [gentoo-dev] Ebuilds for packages without a homepage?

[Simon Stelling]

Ciaran McCreesh wrote:
> For "unknown" or "too lazy" cases, the package shouldn't be in the tree.

Too bad reality doesn't match.

-- 
Simon Stelling
Gentoo/AMD64 Operational Co-Lead
blubb@gentoo.org
-- 
gentoo-dev@gentoo.org mailing list

Re: [gentoo-dev] Ebuilds for packages without a homepage?

[Carsten Lohrke]

[-- Attachment #1: Type: text/plain, Size: 525 bytes --]

On Tuesday 25 October 2005 21:54, Simon Stelling wrote:
> Too bad reality doesn't match.

The list of ebuilds without homepage is indeed quite shocking. When you look 
at our ebuild howto¹, the variables SLOT, LICENSE, KEYWORDS, DESCRIPTION, 
SRC_URI, HOMEPAGE and IUSE are mandatory, so all these ~3000 ebuilds do not 
adhere to our minimum quality standard. Some light on our pretty much 
non-existing QA team, please...


Carsten 

{1] http://www.gentoo.org/proj/en/devrel/handbook/handbook.xml?part=2&chap=1

[-- Attachment #2: Type: application/pgp-signature, Size: 198 bytes --]

Re: [gentoo-dev] Ebuilds for packages without a homepage?

[Carsten Lohrke]

[-- Attachment #1: Type: text/plain, Size: 195 bytes --]

Please forget my earlier email. After having a closer look almost all of those 
ebuilds get the hompage set via the eclass they inherit, so Simons statement 
is pretty much void.


Carsten

[-- Attachment #2: Type: application/pgp-signature, Size: 198 bytes --]

Re: [gentoo-dev] Ebuilds for packages without a homepage?

[Ciaran McCreesh]

[-- Attachment #1: Type: text/plain, Size: 734 bytes --]

On Tue, 25 Oct 2005 20:35:20 +0200 Krzysiek Pawlik
<nelchael@gentoo.org> wrote:
| Marco Morales wrote:
| > I think "none" could be the better workaround imho.
| 
| I vote for "none" too :) It clearly states, that HOMEPAGE is missing.
| Blank HOMEPAGE is misleading.

Then any automated tools will need to be told explicitly that "none" is
something special. With all HOMEPAGE entries being fully qualified URIs,
you can just do something like for h in HOMEPAGE ; do firefox "$h" & ;
done , which works just fine in multiple and blank homepage cases...

-- 
Ciaran McCreesh : Gentoo Developer (Vim, Shell tools, Fluxbox, Cron)
Mail            : ciaranm at gentoo.org
Web             : http://dev.gentoo.org/~ciaranm


[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [gentoo-dev] Ebuilds for packages without a homepage?

[Spider (D.m.D. Lj.)]

[-- Attachment #1: Type: text/plain, Size: 977 bytes --]

On Tue, 2005-10-25 at 20:22 +0100, Ciaran McCreesh wrote:
> On Tue, 25 Oct 2005 20:35:20 +0200 Krzysiek Pawlik
> <nelchael@gentoo.org> wrote:
> | Marco Morales wrote:
> | > I think "none" could be the better workaround imho.
> | 
> | I vote for "none" too :) It clearly states, that HOMEPAGE is missing.
> | Blank HOMEPAGE is misleading.
> 
> Then any automated tools will need to be told explicitly that "none" is
> something special. With all HOMEPAGE entries being fully qualified URIs,
> you can just do something like for h in HOMEPAGE ; do firefox "$h" & ;
> done , which works just fine in multiple and blank homepage cases...


I agree with Ciaran here.  exporting the explicitly empty variable is a
good thing.  If, however the variable is unset completely, then we have
an issue of laziness on a developers part.


//Spider
-- 
begin  .signature
Tortured users / Laughing in pain
See Microsoft KB Article Q265230 for more information.
end


[-- Attachment #2: This is a digitally signed message part --]
[-- Type: application/pgp-signature, Size: 189 bytes --]

Re: [gentoo-dev] Ebuilds for packages without a homepage?

[Brian Harring]

[-- Attachment #1: Type: text/plain, Size: 1387 bytes --]

On Tue, Oct 25, 2005 at 09:36:02PM +0200, Spider (D.m.D. Lj.) wrote:
> On Tue, 2005-10-25 at 20:22 +0100, Ciaran McCreesh wrote:
> > On Tue, 25 Oct 2005 20:35:20 +0200 Krzysiek Pawlik
> > <nelchael@gentoo.org> wrote:
> > | Marco Morales wrote:
> > | > I think "none" could be the better workaround imho.
> > | 
> > | I vote for "none" too :) It clearly states, that HOMEPAGE is missing.
> > | Blank HOMEPAGE is misleading.
> > 
> > Then any automated tools will need to be told explicitly that "none" is
> > something special. With all HOMEPAGE entries being fully qualified URIs,
> > you can just do something like for h in HOMEPAGE ; do firefox "$h" & ;
> > done , which works just fine in multiple and blank homepage cases...
> 
> 
> I agree with Ciaran here.  exporting the explicitly empty variable is a
> good thing.  If, however the variable is unset completely, then we have
> an issue of laziness on a developers part.
Why?

portage substitutes "" when metadata keys are unset during depends 
export.  Seems kind of pointless requiring an empty var- yes it could 
be used for typo checks where the dev does a 

HOMEPAGe="blah"

but no other var has an actual check of that sort- to do the check 
would require mangling ebuild.sh also, which I think is kind of daft.

Repoman complains if the var is unset/empty, works for me personally.
~harring

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [gentoo-dev] Ebuilds for packages without a homepage?

[Ciaran McCreesh]

[-- Attachment #1: Type: text/plain, Size: 504 bytes --]

On Tue, 25 Oct 2005 14:51:26 -0500 Brian Harring <ferringb@gentoo.org>
wrote:
| but no other var has an actual check of that sort- to do the check 
| would require mangling ebuild.sh also, which I think is kind of daft.

Hrm. KEYWORDS.missing, LICENSE.missing, DESCRIPTION.missing and
SLOT.missing are listed in 'man repoman'.

-- 
Ciaran McCreesh : Gentoo Developer (Vim, Shell tools, Fluxbox, Cron)
Mail            : ciaranm at gentoo.org
Web             : http://dev.gentoo.org/~ciaranm


[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [gentoo-dev] Ebuilds for packages without a homepage?

[Brian Harring]

[-- Attachment #1: Type: text/plain, Size: 1346 bytes --]

On Tue, Oct 25, 2005 at 08:57:59PM +0100, Ciaran McCreesh wrote:
> On Tue, 25 Oct 2005 14:51:26 -0500 Brian Harring <ferringb@gentoo.org>
> wrote:
> | portage substitutes "" when metadata keys are unset during depends
> | export.  Seems kind of pointless requiring an empty var
> | <snip>
> | to do the check
> | would require mangling ebuild.sh also, which I think is kind of daft.
> 
> Hrm. KEYWORDS.missing, LICENSE.missing, DESCRIPTION.missing and
> SLOT.missing are listed in 'man repoman'.

Re-read the chunks of my original email above.

The suggestion is requiring

HOMEPAGE=''

in ebuilds, which is daft due to the fact that ebuild.sh does not 
discern between an unset and empty var for exporting.  All stable 
portage (python side) sees is empty, no special flagging of unset.

The repoman checks I commented on, due to ebuild.sh not discerning 
between an unset env var and an empty one, are testing to see if it's 
empty not unset/missing.  It's pointless requiring the var to be set 
empty in the ebuild because portage (by extension repoman) doesn't
know the difference between unset and empty.

Making it aware of the difference is a bit daft also imo; a package 
that lacks a homepage I tend to think should be flagged as a warning, 
regardless if the author set the HOMEPAGE var or not.
~harring

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [gentoo-dev] Ebuilds for packages without a homepage?

[Grant Goodyear]

[-- Attachment #1: Type: text/plain, Size: 771 bytes --]

Ciaran McCreesh wrote: [Tue Oct 25 2005, 02:22:25PM CDT]
> Then any automated tools will need to be told explicitly that "none" is
> something special. With all HOMEPAGE entries being fully qualified URIs,
> you can just do something like for h in HOMEPAGE ; do firefox "$h" & ;
> done , which works just fine in multiple and blank homepage cases...

As an aside, when I put xsnap in the tree long ago, I just 
duplicated the SRC_URI in HOMEPAGE.  I don't know that it's any better a
solution than HOMEPAGE="", but at least it gives people something to
click on who use packages.g.o.

-g2boojum-
-- 
Grant Goodyear	
Gentoo Developer
g2boojum@gentoo.org
http://www.gentoo.org/~g2boojum
GPG Fingerprint: D706 9802 1663 DEF5 81B0  9573 A6DC 7152 E0F6 5B76

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]