Gentoo Archives: gentoo-dev

From: Ciaran McCreesh <ciaranm@g.o>
To: gentoo-dev@l.g.o
Subject: [gentoo-dev] Gratuitous useflaggery (doc and examples)
Date: Sat, 04 Mar 2006 01:07:40
Message-Id: 20060304010439.30478098@snowdrop.home
1 This is undocumented and unofficial, so feel free to utterly ignore it
2 and commit whatever the heck you want.
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.
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.
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.
21 --
22 Ciaran McCreesh : Gentoo Developer (Wearer of the shiny hat)
23 Mail : ciaranm at
24 Web :


File name MIME type
signature.asc application/pgp-signature


Subject Author
Re: [gentoo-dev] Gratuitous useflaggery (doc and examples) Stuart Herbert <stuart.herbert@×××××.com>
Re: [gentoo-dev] Gratuitous useflaggery (doc and examples) Carsten Lohrke <carlo@g.o>