begin  quote
On Sun, 22 Aug 2004 04:34:38 +0200
Karl Trygve Kalleberg <karltk@gentoo.org> wrote:

> 
> In java, we have many libraries that are a few hundred kb, that come
> with multiple megabytes of generated documentation, that you will only
> need if you're a Java developer, and usually not even then.


> Also, as javadoc is a memory hog, generating the documentation may be
> prohibitive on older machines.

Actually, you just describe the reason we implemented the "doc" useflag.
Its not meant for enduser documentation in that sense, but for more
massive, developer oriented documentation that is autogenerated in some
ways.  okay, its misnamed, I realized that afterwards, too late.

it was basically there to stop packages from pulling in t1, tetex,
openjade, ghostscript and the rest, just to parse some .h headers with a
perl script and generate documentation in multitudes of formats.


So, the documentation / javadoc, are best off covered by the USE="doc"
flag, whereas examples should probably be split up a bit further.
(examplecode !) 

Its fairly important that we don't start to misuse such a flag for
example configurations, which should be considered necessary base level
documentation for users, not "examples" in the sense we are talking
about here.

(for a typical "example" app, freepascal is an example ;)


//Spider




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