From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from pigeon.gentoo.org ([69.77.167.62] helo=lists.gentoo.org) by finch.gentoo.org with esmtp (Exim 4.60) (envelope-from ) id 1JEFY4-0003qU-H3 for garchives@archives.gentoo.org; Mon, 14 Jan 2008 02:59:40 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 47668E0C14; Mon, 14 Jan 2008 02:59:38 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by pigeon.gentoo.org (Postfix) with ESMTP id 0A079E0C14 for ; Mon, 14 Jan 2008 02:59:38 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by smtp.gentoo.org (Postfix) with ESMTP id 97314653E5 for ; Mon, 14 Jan 2008 02:59:37 +0000 (UTC) X-Virus-Scanned: amavisd-new at gentoo.org X-Spam-Score: -0.88 X-Spam-Level: X-Spam-Status: No, score=-0.88 required=5.5 tests=[AWL=-0.140, BAYES_20=-0.74] Received: from smtp.gentoo.org ([127.0.0.1]) by localhost (smtp.gentoo.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 1uET0fhhAv6a for ; Mon, 14 Jan 2008 02:59:30 +0000 (UTC) Received: from ciao.gmane.org (main.gmane.org [80.91.229.2]) (using TLSv1 with cipher AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTP id 9B9A464549 for ; Mon, 14 Jan 2008 02:59:29 +0000 (UTC) Received: from list by ciao.gmane.org with local (Exim 4.43) id 1JEFXn-0007yz-VA for gentoo-dev@gentoo.org; Mon, 14 Jan 2008 02:59:23 +0000 Received: from static24-72-113-196.yorkton.accesscomm.ca ([24.72.113.196]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Mon, 14 Jan 2008 02:59:23 +0000 Received: from dirtyepic by static24-72-113-196.yorkton.accesscomm.ca with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Mon, 14 Jan 2008 02:59:23 +0000 X-Injected-Via-Gmane: http://gmane.org/ To: gentoo-dev@lists.gentoo.org From: Ryan Hill Subject: [gentoo-dev] Re: USE flag documentation Date: Sun, 13 Jan 2008 20:59:17 -0600 Message-ID: References: <20080114012453.GG24512@aerie.halcy0n.com> Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@lists.gentoo.org Reply-to: gentoo-dev@lists.gentoo.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Complaints-To: usenet@ger.gmane.org X-Gmane-NNTP-Posting-Host: static24-72-113-196.yorkton.accesscomm.ca User-Agent: Thunderbird 2.0.0.9 (X11/20071218) In-Reply-To: <20080114012453.GG24512@aerie.halcy0n.com> Sender: news X-Archives-Salt: 68c75e69-54e2-4338-b307-79c93345af49 X-Archives-Hash: 455cf114cee0e64e1bf846a13f1a1ff8 Mark Loeser wrote: > Here is a newer revision of the GLEP. I still have multiple methods of > solving this problem (mostly because I want and *need* input from people > as to what they would prefer). Please tell me what you would want to > use so I can come up with a more precise specification. What exactly do > we need this system to do that we can't do now? Is overriding the USE > flag with use.local.desc sufficient and we just need to document the > current solution properly? > > Please...let me know how you feel about this. > > http://dev.gentoo.org/~halcy0n/gleps/glep-0054.html > > Thanks, What do people think of this? a) Keep use.desc as it is: a list of common flags and a short general description of their meaning. b) Keep use.local.desc as it is: a list of per-package flags that are specific to one to a few ebuilds (i think 5 is the number though i think 10 is more appropriate, but that's not relevant to this discussion). Again, each has a short description. c) Allow flags from use.desc to also exist in use.local.desc. In the case that a flag for a package exists in both, the use.local.desc description overrides the use.desc one. This allows a more specific per-package description of global flags. d) Allow long descriptions in a package's metadata.xml, as some have begun to do already, for cases where more info is needed. For example I'd like to explain exactly what the bindist flag on freetype does and what legal implications disabling it can have. The reason I suggest we do it this way is it's very close to what we're already doing now. The only thing we'd need to do is decide it's okay to do (c) and adapt our various utils to use the use.local.desc description when both exist. I actually planned on proposing something like this about a year ago but never got around to it. But at the time I did some poking and found that several of our utils already did the right thing while the others needed minor adjustments (I think I had a one-line patch for equery). We also needn't worry about breaking 3rd party tools. The worst that would happen is they'd display the use.desc description, which is what they do now. On the other hand, if there are any far-reaching changes we need made to the USE flag system - any features we wish we had or misfeatures we wish we didn't - now would be a good time to address them. -- fonts, by design, by neglect gcc-porting, for a fact or just for effect wxwindows @ gentoo EFFD 380E 047A 4B51 D2BD C64F 8AA8 8346 F9A4 0662 -- gentoo-dev@lists.gentoo.org mailing list