Re: [gentoo-dev] Re: New global USE flag: examples

[Matthieu Sozeau <mattam@gentoo.org>]

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

On Monday 23 August 2004 16:36, Mike Frysinger wrote:
> On Monday 23 August 2004 08:30 am, Paul de Vrieze wrote:
> > I disagree with you. Documentation is very different from example
> > applications and the like. The java herd is not the only group having
> > problems with this. Look for example at the formidable example collection
> > provided in qt. In most cases it is not necessary at all to compile them
> > all (take quite some time), while developer docs might be interesting.
>
> doc works fine if you consider the context ...
>
> USE=doc [some programming language] -> i get a lot of programming related
> documentation
USE="doc examples" [some programming language] -> i get the language ref 
manual and library docs + some example programs if provided.

> USE=doc [some program] -> i get a lot of manuals and extraneous things
USE="doc examples" [some program] -> i get a lot of manuals and some sample 
documents (could be used in Dia for example).

USE=doc [some library] -> i get the API docs
USE="doc examples" -> ^^^ + example code/apps

You seem to see it too fine-grained, but there are people who want API docs 
but not example code (I am a living example). USE flags are about 
flexibility, aren't they ? Micheal says there is no need, that's true, but 
some people wish this USE flag existed so they could have more control on 
what's installed.
-- 
"We have art to save ourselves from the truth." 
- Friedrich Nietzsche

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