This is undocumented and unofficial, so feel free to utterly ignore it and commit whatever the heck you want.
The 'doc' and 'examples' (yay for consistency!) USE flags are intended for use where building documentation or examples would take a long time, introduce new dependencies or otherwise be an inconvenience to many users. For example, if libiamafish comes with a half dozen small example source files and a few pages of HTML, just install them. If, however, libiamafish requires, say, doxygen to generate its documentation, or comes with several megabytes of examples in a separate tarball, then you should consider a USE flag. Explanation: a USE flag for trivial stuff that isn't in /etc, doesn't slow anything down, doesn't introduce any dep bloat and generally doesn't change anything noticeable isn't a USE flag that's giving the user any meaningful choice or making things easier for arch teams. You do not get bonus points for using more USE flags. -- Ciaran McCreesh : Gentoo Developer (Wearer of the shiny hat) Mail : ciaranm at gentoo.org Web : http://dev.gentoo.org/~ciaranm
signature.asc
Description: PGP signature
