| 1 |
On Sat, 23 Jun 2007 17:11:16 +0300 |
| 2 |
Petteri Räty <betelgeuse@g.o> wrote: |
| 3 |
> My opinion is to make it clear that the doc use flag always controls |
| 4 |
> whether or not to install documentation and make it clear in the |
| 5 |
> devmanual. |
| 6 |
|
| 7 |
The doc use flag is used where there is a reason to make documentation |
| 8 |
optional rather than mandatory. Examples of such reasons include |
| 9 |
increased dependencies (e.g. Doxygen, which pulls in a fair bit), |
| 10 |
increased build time (e.g. Doxygen, which can be frickin' slow) or |
| 11 |
substantially increased disk usage. If there's no substantial cost to |
| 12 |
documentation, it should always be installed. |
| 13 |
|
| 14 |
-- |
| 15 |
Ciaran McCreesh |
Archives