| 1 |
On 7/13/10 12:32 PM, Jeremy Olexa wrote: |
| 2 |
> On Tue, 13 Jul 2010 19:25:51 +0000 (UTC), "Kacper Kowalik (xarthisius)" |
| 3 |
> <xarthisius@g.o> wrote: |
| 4 |
> |
| 5 |
>> if use doc; then |
| 6 |
>> insinto /usr/share/doc/${PF} |
| 7 |
>> doins doc/*.pdf || die |
| 8 |
> |
| 9 |
> An open question to all: |
| 10 |
> |
| 11 |
> Should we be hiding pdf's behind USE=doc?? I've seen it here and there |
| 12 |
> as of late. I thought USE=doc was for compiling docs and/or pulling in |
| 13 |
> extra deps to build docs. |
| 14 |
|
| 15 |
In my opinion we're never going to have 100% consistency here. I'd say |
| 16 |
let everybody implement it in a way one thinks is the best. |
| 17 |
|
| 18 |
The description of the flag is "Adds extra documentation (API, Javadoc, |
| 19 |
etc)". So if something is an extra documentation, it seems to be fine to |
| 20 |
"hide" it behind USE=doc. |
| 21 |
|
| 22 |
And I'd prefer to keep the meaning of "extra documentation" flexible and |
| 23 |
open to interpretation, just because there is no obvious benefit to aim |
| 24 |
for 100% consistency here, and overstandardization would be bad. |
| 25 |
|
| 26 |
Paweł |
Archives