Gentoo Archives: gentoo-portage-dev

From: "Robin H. Johnson" <robbat2@g.o>
To: gentoo-portage-dev@l.g.o
Subject: Re: [gentoo-portage-dev] [PATCH] make.conf.5: Document PYTHON_TARGETS, bug #493180
Date: Tue, 03 Dec 2013 16:52:55
Message-Id: robbat2-20131203T165044-013605591Z@orbis-terrarum.net
In Reply to: Re: [gentoo-portage-dev] [PATCH] make.conf.5: Document PYTHON_TARGETS, bug #493180 by Mike Frysinger
1 On Tue, Dec 03, 2013 at 11:05:51AM -0500, Mike Frysinger wrote:
2 > as for the patch, i'm of the opinion that make.conf is not for documenting
3 > random USE_EXPAND-ed variables.
4 ...
5 > there is the matter of visibility ... we could add a generic pointer to the
6 > make.conf man page discussing that there are many more variables that might
7 > impact the build and to look at the man page for the eclasses.
8 Can I make a possible additional suggestion?
9
10 We do already have profiles/${VAR}.desc, describing what the settings
11 themselves do. Can we augment those files to describe the variable
12 itself?
13
14 Then put a generic note in make.conf about reading those (or something
15 to build docs from them like the eclass docs).
16
17 --
18 Robin Hugh Johnson
19 Gentoo Linux: Developer, Infrastructure Lead
20 E-Mail : robbat2@g.o
21 GnuPG FP : 11ACBA4F 4778E3F6 E4EDF38E B27B944E 34884E85

Replies