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

[Marius Mauch <genone@gentoo.org>]

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

On Sat, 23 Jun 2007 17:11:16 +0300
Petteri Räty <betelgeuse@gentoo.org> wrote:

> My opinion is to make it clear that the doc use flag always controls
> whether or not to install documentation and make it clear in the
> devmanual. For what gnome does, they can then add for example a
> gtk-doc use flag to control the building of the cross references and
> have the doc use flag control the installation of the bundled
> documentation.
> 
> betelgeuse@pena ~ $ euse -i doc
> global use flags (searching: doc)
> ************************************************************
> [-    ] doc - Adds extra documentation (API, Javadoc, etc)
> 
> INSTALL_MASK is of course a solution to not installing gtk-doc at all
> but it doesn't give me the ability to install it only for individual
> packages.
> 
> What do others think?

Maybe the flag needs to be renamed/split up to clarify it's meaning,
it's too generic in it's current form (many people enable it blindly and
don't really have any clue what the result is). 
Like using USE=apidoc for API documentation, USE=extradoc for extra
user documentation (controlling PDF generation and stuff like that),
USE=rebuild-docs to replace pregenerated documentation with
updated/regenerated versions (like the gtk-doc issue), and so on (don't
know what other use cases there are for USE=doc currently).

It's a large change, but USE=doc has been a significant problem for
quite a while already (circular deps anyone?)

Marius

-- 
Public Key at http://www.genone.de/info/gpg-key.pub

In the beginning, there was nothing. And God said, 'Let there be
Light.' And there was still nothing, but you could see a bit better.

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