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 <gentoo-dev+bounces-27780-garchives=archives.gentoo.org@gentoo.org>)
	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 <gentoo-dev@lists.gentoo.org>; 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 <r0bertz@gentoo.org>, 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 <gentoo-dev@lists.gentoo.org>; 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 <r0bertz@gentoo.org>
User-Agent: Thunderbird 2.0.0.9 (X11/20071123)
Precedence: bulk
List-Post: <mailto:gentoo-dev@lists.gentoo.org>
List-Help: <mailto:gentoo-dev+help@gentoo.org>
List-Unsubscribe: <mailto:gentoo-dev+unsubscribe@gentoo.org>
List-Subscribe: <mailto:gentoo-dev+subscribe@gentoo.org>
List-Id: Gentoo Linux mail <gentoo-dev.gentoo.org>
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> <b41005390711271910n74d15a96w16681f40294a5fa@mail.gmail.com> <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 <dberkholz@gentoo.org> 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