On Sat, 23 Jun 2007 17:11:16 +0300 Petteri Räty 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.