| 1 |
On Sat, 23 Jun 2007 17:45:02 +0300 |
| 2 |
Petteri Räty <betelgeuse@g.o> wrote: |
| 3 |
> > The doc use flag is used where there is a reason to make |
| 4 |
> > documentation optional rather than mandatory. Examples of such |
| 5 |
> > reasons include increased dependencies (e.g. Doxygen, which pulls |
| 6 |
> > in a fair bit), increased build time (e.g. Doxygen, which can be |
| 7 |
> > frickin' slow) or substantially increased disk usage. If there's no |
| 8 |
> > substantial cost to documentation, it should always be installed. |
| 9 |
> > |
| 10 |
> |
| 11 |
> Yep but we should for example document what constitues increased disk |
| 12 |
> usage. How about "several megabytes or tens of files"? |
| 13 |
|
| 14 |
It's a package dependent quantity, and should be left up to individual |
| 15 |
maintainers. Vim's documentation, for example, is a lot of files and a |
| 16 |
lot of disk space, but it isn't shipped via USE="doc" because it's |
| 17 |
considered by upstream to be a vital part of the package. |
| 18 |
|
| 19 |
-- |
| 20 |
Ciaran McCreesh |
Archives