Gentoo Archives: gentoo-dev

From: Jason Stubbs <jasonbstubbs@×××××××××××.com>
To: gentoo-dev@g.o
Subject: [gentoo-dev] per-package USE documentation (from gentoo-doc)
Date: Mon, 08 Dec 2003 11:50:56
1 Hello all,
3 Below is an excerpt from a post just sent to -doc.
5 On Tuesday 09 December 2003 01:47, Joel Konkle-Parker wrote:
6 > I can't tell you how many times I've sat and wondered what effect a
7 > particular flag has on a particular package, and the use.desc descriptions
8 > are much too brief to give any kind of useful detail (and the use.local.desc
9 > descriptions are just for local flags, not global ones). For example:
10 >
11 > "What effect does USE="xml2" have on xfree?"
12 > "Why does w3m need USE="imlib"?
13 > "Why should I keep USE="berkdb"?
14 >
15 > Other flags change meanings from package to package. USE="java" for gcc is
16 > for java development. The same flag for mozilla is for java end-users.
18 I must admit, I've thought the same things as well. Is this something that
19 anybody else worries about too? That the USE flags are too general or at
20 least not well enough defined.
22 Taking the "java" USE flag example above, I can think of three classes of
23 user:
24 a) People who just want java support for web-browsing
25 b) People who do java development but never use gcj
26 c) People who want to use gcj
28 I'd say 99% of users fit into the first two categories, yet 99% of users will
29 have gcj installed (which seems to be responsible for half the build time of
30 the gcc suite).
32 Hmmm, just looking through use.desc I couldn't really see any many other flags
33 that immediately sprang to mind as being as bad as the "java" one. "mysql" is
34 definately another candidate.
36 Another problem along similar lines is that some flags are used when the
37 function they perform is slightly different to the flags definition. An
38 example is the truetype flag which by definition "Adds support for FreeType
39 and/or FreeType2 fonts". Yet, with X11 it also installs fonts.
41 Perhaps it's time for a review? Or am I just being pedantic? If no one tells
42 me I'm crazy, I might start reviewing myself because even though USE flags
43 are meant to remove most of the bulk that other distros add, it seems to me
44 that they are also responsible for adding it.
46 Regards,
47 Jason Stubbs
49 --
50 gentoo-dev@g.o mailing list


Subject Author
Re: [gentoo-dev] per-package USE documentation (from gentoo-doc) Jeremy Maitin-Shepard <jbms@g.o>
Re: [gentoo-dev] per-package USE documentation (from gentoo-doc) Jason Stubbs <jasonbstubbs@×××××××××××.com>