From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from lists.gentoo.org ([140.105.134.102] helo=robin.gentoo.org) by finch.gentoo.org with esmtp (Exim 4.60) (envelope-from ) id 1IvwqH-0006Ut-6h for garchives@archives.gentoo.org; Sat, 24 Nov 2007 15:22:49 +0000 Received: from robin.gentoo.org (localhost [127.0.0.1]) by robin.gentoo.org (8.14.2/8.14.0) with SMTP id lAOFLvno031413; Sat, 24 Nov 2007 15:21:57 GMT Received: from eastrmmtao107.cox.net (eastrmmtao107.cox.net [68.230.240.59]) by robin.gentoo.org (8.14.2/8.14.0) with ESMTP id lAOFJwjc028815 for ; Sat, 24 Nov 2007 15:19:58 GMT Received: from eastrmimpo01.cox.net ([68.1.16.119]) by eastrmmtao107.cox.net (InterMail vM.7.08.02.01 201-2186-121-102-20070209) with ESMTP id <20071124151957.TBIU26079.eastrmmtao107.cox.net@eastrmimpo01.cox.net> for ; Sat, 24 Nov 2007 10:19:57 -0500 Received: from [192.168.2.55] ([24.250.249.230]) by eastrmimpo01.cox.net with bizsmtp id GfKW1Y0084z0UNo0000000; Sat, 24 Nov 2007 10:19:30 -0500 Message-ID: <4748411B.4040709@gentoo.org> Date: Sat, 24 Nov 2007 10:19:55 -0500 From: Doug Goldstein User-Agent: Thunderbird 2.0.0.9 (Windows/20071031) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@gentoo.org Reply-to: gentoo-dev@lists.gentoo.org MIME-Version: 1.0 To: gentoo-dev@lists.gentoo.org Subject: Re: [gentoo-dev] New USE flags documentation References: <20071124130354.GA8295@gentoo.org> In-Reply-To: <20071124130354.GA8295@gentoo.org> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Archives-Salt: 183ed3fd-4ea4-43b7-a54c-1a39ba232317 X-Archives-Hash: 388dd9b3f537e6df946eced8212c615c Jose Luis Rivero wrote: > Hi all: > > I've read on the planet the recently included support to document USE > flags in metadata. Seems like it was an idea from flameeyes and cardoe, > discussed on the planet [1][2] and performed by -infra (bug #199788). > > While planet is a good medium to share ideas and get contributors, seems to > me like we need a more official way to discuss this kind of 'global' > ideas before make them real. Or at least drop a note on -dev-announce > explaining the new feature and telling devs and users this is now > officially supported. > Thank you for taking the time to announce it to gentoo-dev since I haven't had the time with my family being here for the holidays to do such. I'll take care of the e-mail to gentoo-dev-announce though. > I'm not asking for an extra overhead of 'bureaucracy' (write specs, > mailling @dev, send to the council, etc.) but a bit more of communication > would be appreciated: > All the above is completely unnecessary and I would be happy to discuss details with you off list. > Is the feature ready to be used? Is there any kind of documentation > (aside of DTD)? It will replace use.desc? > Well the first question you answered yourself. You linked to a post I wrote describing live commits I made to the tree using this feature. As far as documentation, you will find that in your Gentoo Developer's Handbook [3], but most likely you'll say "But Doug, I don't see anything on these new changes." That's because the new changes have not been updated yet, again with the holiday's about it takes a little bit to get things done. Once the documentation is updated I had planned on sending an e-mail to gentoo-dev and gentoo-dev-announce. As far as replacing use.desc, that is doubtful but a possibility of replacing use.local.desc is within consideration. However this would be in the distant future and we would have to see how the new features are used and evolve. > Thanks. > > [1] http://farragut.flameeyes.is-a-geek.org/articles/2007/11/24/proposing-more-use-flag-documentation > [2] http://blog.cardoe.com/archives/2007/11/23/metadataxml-updates-examples/ > > [3] http://www.gentoo.org/proj/en/devrel/handbook/handbook.xml?part=2&chap=4 -- gentoo-dev@gentoo.org mailing list