Gentoo Archives: gentoo-dev

From: Duncan <1i5t5.duncan@×××.net>
To: gentoo-dev@l.g.o
Subject: [gentoo-dev] Re: Purpose of USE=doc
Date: Wed, 26 Apr 2006 07:35:36
Message-Id: pan.2006.04.26.07.31.25.464926@cox.net
In Reply to: [gentoo-dev] Purpose of USE=doc by Jakub Moc
1 Jakub Moc posted <444E6454.5040907@g.o>, excerpted below, on Tue,
2 25 Apr 2006 20:03:00 +0200:
3
4 > I'd like to see some clarification of intended doc use flag usage, so that
5 > we wouldn't force users to download/install 40+ megs of docs for a ~3 meg
6 > package, with the only reason being that USE=doc is for developer
7 > documentation only. [1]
8 >
9 > And no, I don't think we need yet another use flag. ;) FEATURES="nodoc" is
10 > also not exactly useful as it's forcing users to download stuff they are
11 > not interested in at all. (To make it more clear, I'm talking about
12 > ebuilds that download docs in a separate tarball here.)
13 >
14 > [1] http://bugs.gentoo.org/show_bug.cgi?id=122265
15
16 Maybe I'll get shot down for this, but IMO, there's nothing wrong with
17 individual packages having a local userdoc USE flag. I don't believe it
18 needs to be global, and in the general case its use would be discouraged,
19 but it seems reasonable in extreme cases like the above, where the docs
20 tarball is ten times the size of the source tarball. Maybe make it a
21 policy that the flag is only to be used when docs are a minimum of three
22 times (or twice?) the source tarball size and at least 10 MB, and then dev
23 discretion is advised?
24
25 --
26 Duncan - List replies preferred. No HTML msgs.
27 "Every nonfree program has a lord, a master --
28 and if you use the program, he is your master." Richard Stallman in
29 http://www.linuxdevcenter.com/pub/a/linux/2004/12/22/rms_interview.html
30
31
32 --
33 gentoo-dev@g.o mailing list