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 1IxRQR-0002Eh-0T for garchives@archives.gentoo.org; Wed, 28 Nov 2007 18:14:19 +0000 Received: from robin.gentoo.org (localhost [127.0.0.1]) by robin.gentoo.org (8.14.2/8.14.0) with SMTP id lASICvo6030780; Wed, 28 Nov 2007 18:12:57 GMT Received: from crux.i-cable.com (crux.i-cable.com [203.83.115.104]) by robin.gentoo.org (8.14.2/8.14.0) with SMTP id lASI9hAv025965 for ; Wed, 28 Nov 2007 18:09:44 GMT Received: (qmail 29468 invoked by uid 107); 28 Nov 2007 18:09:42 -0000 Received: from 203.83.114.121 by crux (envelope-from , uid 104) with qmail-scanner-2.01 (clamdscan: 0.90.3/4349. spamassassin: 2.63. Clear:RC:1(203.83.114.121):SA:0(-2.2/5.0):. Processed in 5.459819 secs); 28 Nov 2007 18:09:42 -0000 X-Spam-Status: No, score=-2.2 required=5.0 X-Spam-Level: Received: from ip114121.hkicable.com (HELO silicon.i-cable.com) (203.83.114.121) by 0 with SMTP; 28 Nov 2007 18:09:36 -0000 Received: from [192.168.1.100] (cm222-167-208-85.hkcable.com.hk [222.167.208.85]) by silicon.i-cable.com (8.13.5/8.13.5) with ESMTP id lASI9afx000385 for ; Thu, 29 Nov 2007 02:09:36 +0800 (HKT) Message-ID: <474DAF99.4060909@gentoo.org> Date: Thu, 29 Nov 2007 02:12:41 +0800 From: Zhang Le User-Agent: Thunderbird 2.0.0.9 (X11/20071123) 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] [RFC] Features and documentation References: <20071127192144.GP4368@supernova> <474D111A.9080102@gentoo.org> In-Reply-To: <474D111A.9080102@gentoo.org> X-Enigmail-Version: 0.95.5 OpenPGP: id=1E4E2973 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable X-MIME-Autoconverted: from 8bit to quoted-printable by robin.gentoo.org id lASICvpl030780 X-Archives-Salt: 8efd0eec-bfd9-4962-a0fa-ba4a8498449f X-Archives-Hash: e985552853f02c2bc05b6d7a3fa52462 R=E9mi Cardona wrote: > Alec Warner wrote: >> On 11/27/07, Donnie Berkholz wrote: >>> How the recent changes happened to allow USE flag descriptions in >>> metadata.xml (which I'm not taking any position on now) gave me an id= ea. >>> The Linux kernel requires that any needed documentation accompany all >>> changes requiring said documentation -- part of the source-code patch >>> must apply to the Documentation/ directory. Should we require that >>> before you commit any changes, you (or someone) write the documentati= on >>> for them and commit it or submit a patch at the same time? >>> >>> To sum up: No undocumented changes. >> No, because this is not a realistic requirement, it's an ideal case. >> People will just commit changes without documentation anyway. >=20 > What if Donnie had used s/changes/new features/ ? Then his proposal > makes much more sense. I agree that new features makes more sense here. USE flag description in metadata.xml is just an example of new feature, IMO. My 2 HK$, ;) --=20 Zhang Le, Robert GPG key ID: 1E4E2973 Fingerprint: 0260 C902 B8F8 6506 6586 2B90 BC51 C808 1E4E 2973 --=20 gentoo-dev@gentoo.org mailing list