From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) by finch.gentoo.org (Postfix) with ESMTP id EC086138247 for ; Tue, 3 Dec 2013 13:45:15 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 3490BE0BE5; Tue, 3 Dec 2013 13:45:14 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 4430FE0BE6 for ; Tue, 3 Dec 2013 13:45:13 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by smtp.gentoo.org (Postfix) with ESMTP id 86BE233ED47 for ; Tue, 3 Dec 2013 13:45:12 +0000 (UTC) X-Virus-Scanned: by amavisd-new using ClamAV at gentoo.org X-Spam-Flag: NO X-Spam-Score: -1.225 X-Spam-Level: X-Spam-Status: No, score=-1.225 tagged_above=-999 required=5.5 tests=[AWL=-1.222, RCVD_IN_DNSWL_NONE=-0.0001, RP_MATCHES_RCVD=-0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001] autolearn=no Received: from smtp.gentoo.org ([IPv6:::ffff:127.0.0.1]) by localhost (smtp.gentoo.org [IPv6:::ffff:127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 5xzh4st5ocSO for ; Tue, 3 Dec 2013 13:45:06 +0000 (UTC) Received: from plane.gmane.org (plane.gmane.org [80.91.229.3]) (using TLSv1 with cipher AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id B516D33DA56 for ; Tue, 3 Dec 2013 13:45:06 +0000 (UTC) Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1VnqHG-0004sw-NY for gentoo-portage-dev@gentoo.org; Tue, 03 Dec 2013 14:44:38 +0100 Received: from ip68-231-22-224.ph.ph.cox.net ([68.231.22.224]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Tue, 03 Dec 2013 14:44:38 +0100 Received: from 1i5t5.duncan by ip68-231-22-224.ph.ph.cox.net with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Tue, 03 Dec 2013 14:44:38 +0100 X-Injected-Via-Gmane: http://gmane.org/ To: gentoo-portage-dev@lists.gentoo.org From: Duncan <1i5t5.duncan@cox.net> Subject: [gentoo-portage-dev] Re: [PATCH] make.conf.5: Document PYTHON_TARGETS, bug #493180 Date: Tue, 3 Dec 2013 13:43:49 +0000 (UTC) Message-ID: References: <1386062367-27184-1-git-send-email-alexander@plaimi.net> <529DA88A.8020203@gmx.de> <529DADB6.4090404@plaimi.net> <529DB0B6.8040804@gmx.de> <529DB5DE.8080100@plaimi.net> Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-portage-dev@lists.gentoo.org Reply-to: gentoo-portage-dev@lists.gentoo.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Complaints-To: usenet@ger.gmane.org X-Gmane-NNTP-Posting-Host: ip68-231-22-224.ph.ph.cox.net User-Agent: Pan/0.140 (Chocolate Salty Balls; GIT 7161f50 /usr/src/portage/src/egit-src/pan2) X-Archives-Salt: 3978b7d9-dc6c-4535-a7f9-aaee445a60ed X-Archives-Hash: 878f83d61406039b3d0dddaa6cae39d7 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