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

["Petteri Räty" <betelgeuse@gentoo.org>]

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

Marius Mauch kirjoitti:
> 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?)
> 

That does sound like a good idea.

Regards,
Petteri


[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 252 bytes --]