Gentoo Logo
Gentoo Spaceship




Note: Due to technical difficulties, the Archives are currently not up to date. GMANE provides an alternative service for most mailing lists.
c.f. bug 424647
List Archive: gentoo-dev
Navigation:
Lists: gentoo-dev: < Prev By Thread Next > < Prev By Date Next >
Headers:
To: gentoo-dev@g.o
From: "Paweł Hajdan, Jr." <phajdan.jr@g.o>
Subject: Re: USE=doc for .pdf's ? (WAS: Re: [gentoo-commits] gentoo-x86 commit in sci-astronomy/kapteyn: metadata.xml ChangeLog kapteyn-1.9.2.ebuild)
Date: Tue, 13 Jul 2010 12:43:17 -0700
On 7/13/10 12:32 PM, Jeremy Olexa wrote:
> On Tue, 13 Jul 2010 19:25:51 +0000 (UTC), "Kacper Kowalik (xarthisius)"
> <xarthisius@g.o> wrote:
> 
>> 	if use doc; then
>> 		insinto /usr/share/doc/${PF}
>> 		doins doc/*.pdf || die
> 
> An open question to all:
> 
> Should we be hiding pdf's behind USE=doc?? I've seen it here and there
> as of late. I thought USE=doc was for compiling docs and/or pulling in
> extra deps to build docs.

In my opinion we're never going to have 100% consistency here. I'd say
let everybody implement it in a way one thinks is the best.

The description of the flag is "Adds extra documentation (API, Javadoc,
etc)". So if something is an extra documentation, it seems to be fine to
"hide" it behind USE=doc.

And I'd prefer to keep the meaning of "extra documentation" flexible and
open to interpretation, just because there is no obvious benefit to aim
for 100% consistency here, and overstandardization would be bad.

Paweł

Attachment:
signature.asc (OpenPGP digital signature)
Replies:
Re: USE=doc for .pdf's ? (WAS: Re: [gentoo-commits] gentoo-x86 com mit in sci-astronomy/kapteyn: metadata.xml ChangeLo g kapteyn-1.9.2.ebuild)
-- Jeremy Olexa
References:
USE=doc for .pdf's ? (WAS: Re: [gentoo-commits] gentoo-x86 commit in sci-as tronomy/kapteyn: metadata.xml ChangeLog kapteyn-1 .9.2.ebuild)
-- Jeremy Olexa
Navigation:
Lists: gentoo-dev: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
USE=doc for .pdf's ? (WAS: Re: [gentoo-commits] gentoo-x86 commit in sci-as tronomy/kapteyn: metadata.xml ChangeLog kapteyn-1 .9.2.ebuild)
Next by thread:
Re: USE=doc for .pdf's ? (WAS: Re: [gentoo-commits] gentoo-x86 com mit in sci-astronomy/kapteyn: metadata.xml ChangeLo g kapteyn-1.9.2.ebuild)
Previous by date:
USE=doc for .pdf's ? (WAS: Re: [gentoo-commits] gentoo-x86 commit in sci-as tronomy/kapteyn: metadata.xml ChangeLog kapteyn-1 .9.2.ebuild)
Next by date:
Re: USE=doc for .pdf's ? (WAS: Re: [gentoo-commits] gentoo-x86 commit in sci-astronomy/kapteyn: metadata.xml ChangeLog kapteyn-1.9.2.ebuild)


Updated Jun 29, 2012

Summary: Archive of the gentoo-dev mailing list.

Donate to support our development efforts.

Copyright 2001-2013 Gentoo Foundation, Inc. Questions, Comments? Contact us.