Alexander Berntsen posted on Tue, 03 Dec 2013 11:43:42 +0100 as excerpted: > On 03/12/13 11:21, Sebastian Luther wrote: >> The problem with all these variables is that we don't maintain them. If >> they disappear, change meaning or new ones are added we constantly have >> to fix our documentation. > I don't think this is a problem. I could fix any documentation bugs > related to this. > >> The python team's documentation [1] is just fine imo. Maybe this one >> needs to be more user visible? Maybe by linking it into the handbook >> (if it isn't already)? > It could be linked in the man page of make.conf as well. > > > Ultimately my stance is that it should be in the man page. I can add > them myself. However, I will leave it out if more people agree with > Sebastian than me.
User contribution, FWIW: I'll stay neutral on having it in the manpage, but I definitely agree PYTHON_TARGETS and PYTHON_SINGLE_TARGET need more visibility, and I like the proposed explanation in the patch very much, as it finally cleared up the relationship between the two of them for me. And given my level of gentoo knowledge and experience, if I was a bit confused by the two separate python-targets settings and unaware of the precise relationship between them as well as their defaults, I think it's a pretty safe bet that well above 90% of the user base is at least as confused as I was if not more so. So manpage or some other location I'm not sure, but I definitely agree it's not documented well enough now, and the proposed patch would at least give it /some/ visibility. Regardless of whether it gets in the manpage, tho, can I suggest mentioning that definition in the next GMN, gentoo monthly newsletter, now that it has been resurrected? The handbook and/or manpage are good, but that won't necessarily reach the existing users GMN should, even if it doesn't reach them all. From there the explanation will hopefully spread via the users themselves. =:^) -- Duncan - List replies preferred. No HTML msgs. "Every nonfree program has a lord, a master -- and if you use the program, he is your master." Richard Stallman
