| 1 |
On Sat, 23 Jun 2007 17:11:16 +0300 |
| 2 |
Petteri Räty <betelgeuse@g.o> wrote: |
| 3 |
|
| 4 |
> My opinion is to make it clear that the doc use flag always controls |
| 5 |
> whether or not to install documentation and make it clear in the |
| 6 |
> devmanual. For what gnome does, they can then add for example a |
| 7 |
> gtk-doc use flag to control the building of the cross references and |
| 8 |
> have the doc use flag control the installation of the bundled |
| 9 |
> documentation. |
| 10 |
> |
| 11 |
> betelgeuse@pena ~ $ euse -i doc |
| 12 |
> global use flags (searching: doc) |
| 13 |
> ************************************************************ |
| 14 |
> [- ] doc - Adds extra documentation (API, Javadoc, etc) |
| 15 |
> |
| 16 |
> INSTALL_MASK is of course a solution to not installing gtk-doc at all |
| 17 |
> but it doesn't give me the ability to install it only for individual |
| 18 |
> packages. |
| 19 |
> |
| 20 |
> What do others think? |
| 21 |
|
| 22 |
Maybe the flag needs to be renamed/split up to clarify it's meaning, |
| 23 |
it's too generic in it's current form (many people enable it blindly and |
| 24 |
don't really have any clue what the result is). |
| 25 |
Like using USE=apidoc for API documentation, USE=extradoc for extra |
| 26 |
user documentation (controlling PDF generation and stuff like that), |
| 27 |
USE=rebuild-docs to replace pregenerated documentation with |
| 28 |
updated/regenerated versions (like the gtk-doc issue), and so on (don't |
| 29 |
know what other use cases there are for USE=doc currently). |
| 30 |
|
| 31 |
It's a large change, but USE=doc has been a significant problem for |
| 32 |
quite a while already (circular deps anyone?) |
| 33 |
|
| 34 |
Marius |
| 35 |
|
| 36 |
-- |
| 37 |
Public Key at http://www.genone.de/info/gpg-key.pub |
| 38 |
|
| 39 |
In the beginning, there was nothing. And God said, 'Let there be |
| 40 |
Light.' And there was still nothing, but you could see a bit better. |
Archives