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