Re: [gentoo-dev] RFC: Unifying the behavior of the doc use flag and document it

[Ciaran McCreesh <ciaranm@ciaranm.org>]

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

On Sat, 23 Jun 2007 17:45:02 +0300
Petteri Räty <betelgeuse@gentoo.org> wrote:
> > The doc use flag is used where there is a reason to make
> > documentation optional rather than mandatory. Examples of such
> > reasons include increased dependencies (e.g. Doxygen, which pulls
> > in a fair bit), increased build time (e.g. Doxygen, which can be
> > frickin' slow) or substantially increased disk usage. If there's no
> > substantial cost to documentation, it should always be installed.
> > 
> 
> Yep but we should for example document what constitues increased disk
> usage. How about "several megabytes or tens of files"?

It's a package dependent quantity, and should be left up to individual
maintainers. Vim's documentation, for example, is a lot of files and a
lot of disk space, but it isn't shipped via USE="doc" because it's
considered by upstream to be a vital part of the package.

-- 
Ciaran McCreesh


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