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 1JEuly-0006Ju-Eu for garchives@archives.gentoo.org; Tue, 15 Jan 2008 23:00:46 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 900E0E079F; Tue, 15 Jan 2008 23:00:44 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by pigeon.gentoo.org (Postfix) with ESMTP id 6B9A5E079F for ; Tue, 15 Jan 2008 23:00:44 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by smtp.gentoo.org (Postfix) with ESMTP id D986B658F5 for ; Tue, 15 Jan 2008 23:00:43 +0000 (UTC) X-Virus-Scanned: amavisd-new at gentoo.org X-Spam-Score: -1.064 X-Spam-Level: X-Spam-Status: No, score=-1.064 required=5.5 tests=[AWL=0.046, BAYES_05=-1.11] 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 nA00AMJ7S8hV for ; Tue, 15 Jan 2008 23:00:37 +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 E6A6064FDC for ; Tue, 15 Jan 2008 23:00:34 +0000 (UTC) Received: from list by ciao.gmane.org with local (Exim 4.43) id 1JEulk-00008a-6I for gentoo-dev@gentoo.org; Tue, 15 Jan 2008 23:00:32 +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 ; Tue, 15 Jan 2008 23:00:32 +0000 Received: from dirtyepic by static24-72-113-196.yorkton.accesscomm.ca with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Tue, 15 Jan 2008 23:00:32 +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: Tue, 15 Jan 2008 17:00:20 -0600 Message-ID: References: <20080114012453.GG24512@aerie.halcy0n.com> <20080114180225.GB10389@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: <20080114180225.GB10389@aerie.halcy0n.com> Sender: news X-Archives-Salt: e60e4789-f7d5-488b-959a-cc3ac2abdaf6 X-Archives-Hash: d2af2851b4d211ad2f3d1345e4ba5eab Mark Loeser wrote: > Ryan Hill said: >> a) Keep use.desc as it is: a list of common flags and a short general >> description of their meaning. > > Sounds good. > >> 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. > > Also fine. > >> 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. > > Still doing alright :) > >> 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. > > Why can't this be done in use.local.desc? My expectation is that `grep "flag" use.local.desc` will give me a list of packages using that flag (or having it in the description), one per line. Putting paragraphs in there doesn't seem right. -- 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