On Tue, Dec 03, 2013 at 11:05:51AM -0500, Mike Frysinger wrote:
> as for the patch, i'm of the opinion that make.conf is not for documenting 
> random USE_EXPAND-ed variables.
...
> there is the matter of visibility ... we could add a generic pointer to the 
> make.conf man page discussing that there are many more variables that might 
> impact the build and to look at the man page for the eclasses.
Can I make a possible additional suggestion?

We do already have profiles/${VAR}.desc, describing what the settings
themselves do. Can we augment those files to describe the variable
itself?

Then put a generic note in make.conf about reading those (or something
to build docs from them like the eclass docs).

-- 
Robin Hugh Johnson
Gentoo Linux: Developer, Infrastructure Lead
E-Mail     : robb...@gentoo.org
GnuPG FP   : 11ACBA4F 4778E3F6 E4EDF38E B27B944E 34884E85

Reply via email to