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 1JF3ou-0002KY-GR for garchives@archives.gentoo.org; Wed, 16 Jan 2008 08:40:24 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 1704DE071B; Wed, 16 Jan 2008 08:39:48 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by pigeon.gentoo.org (Postfix) with ESMTP id E8BC9E076C for ; Wed, 16 Jan 2008 08:39:47 +0000 (UTC) Received: from gentoo.org (c-67-171-150-177.hsd1.or.comcast.net [67.171.150.177]) (using TLSv1 with cipher DHE-RSA-AES128-SHA (128/128 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTP id D0A9265AEB for ; Wed, 16 Jan 2008 08:39:46 +0000 (UTC) Date: Wed, 16 Jan 2008 00:39:45 -0800 From: Donnie Berkholz To: gentoo-dev@lists.gentoo.org Subject: Re: [gentoo-dev] Re: USE flag documentation Message-ID: <20080116083945.GA28227@supernova> References: <20080114012453.GG24512@aerie.halcy0n.com> <20080114180225.GB10389@aerie.halcy0n.com> <1200450219.6149.45.camel@inertia.twi-31o2.org> 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=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.16 (2007-06-09) X-Archives-Salt: d78e72bb-04af-456e-8711-d913dced00cc X-Archives-Hash: 8c03db64bb14ab0642b8933bc3c0ca0e On 18:45 Tue 15 Jan , Alec Warner wrote: > On 1/15/08, Chris Gianelloni wrote: > > On Tue, 2008-01-15 at 17:00 -0600, Ryan Hill wrote: > > > 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. > > > > A single long line still fills this "requirement" for us. However, it > > does bring up the point. Why even have use.local.desc (or > > metadata.xml's tag) at all? Is there really a need for a *global* > > list of flags that are ebuild-specific? (I don't care or have much > > opinion, either way, I'm merely presenting some topic for discussion on > > this.) > > The global use.* files are convenient because it means we don't need > to generate or push a cache for the data (like for metadata). If it > was per package or per-ebuild we would need to generate a cache to > answer queries like 'what does the "foo" flag do'. Since Chris only mentioned use.local.desc, I'm assuming he only meant local flags rather than use.desc also. In that case, asking what the "foo" local flag does doesn't make sense, because it does something different depending on the package you're curious about. Centralizing what feels like inherently local data seems odd to me. USE flag editors would still need to generate a complete list, though, so this would make more work for them. Chris, I'm not entirely clear what you meant by your suggestion of also dropping metadata.xml ; where would we describe local flags? Thanks, Donnie -- gentoo-dev@lists.gentoo.org mailing list