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 1IxGwI-0008NW-6o for garchives@archives.gentoo.org; Wed, 28 Nov 2007 07:02:30 +0000 Received: from robin.gentoo.org (localhost [127.0.0.1]) by robin.gentoo.org (8.14.2/8.14.0) with SMTP id lAS71YbI024478; Wed, 28 Nov 2007 07:01:34 GMT Received: from smtp8-g19.free.fr (smtp8-g19.free.fr [212.27.42.65]) by robin.gentoo.org (8.14.2/8.14.0) with ESMTP id lAS6xgg6020700 for ; Wed, 28 Nov 2007 06:59:42 GMT Received: from smtp8-g19.free.fr (localhost [127.0.0.1]) by smtp8-g19.free.fr (Postfix) with ESMTP id 7632117F53E for ; Wed, 28 Nov 2007 07:59:42 +0100 (CET) Received: from [192.168.0.13] (bne75-10-88-178-16-229.fbx.proxad.net [88.178.16.229]) by smtp8-g19.free.fr (Postfix) with ESMTP id 49FFD17F513 for ; Wed, 28 Nov 2007 07:59:42 +0100 (CET) Message-ID: <474D111A.9080102@gentoo.org> Date: Wed, 28 Nov 2007 07:56:26 +0100 From: =?ISO-8859-1?Q?R=E9mi_Cardona?= User-Agent: Thunderbird 2.0.0.9 (X11/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] [RFC] Features and documentation References: <20071127192144.GP4368@supernova> In-Reply-To: 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 lAS71Ycx024478 X-Archives-Salt: 115a3e2b-69dc-438f-b441-eaf5958071f1 X-Archives-Hash: b1693b7f793b7686c0204f366b1e3ad6 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 ide= a. >> 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 documentatio= n >> for them and commit it or submit a patch at the same time? >> >> To sum up: No undocumented changes. >=20 > No, because this is not a realistic requirement, it's an ideal case. > People will just commit changes without documentation anyway. What if Donnie had used s/changes/new features/ ? Then his proposal makes much more sense. For bugfix, we already have ChangeLogs. My 2 euro =A2 Cheers, R=E9mi --=20 gentoo-dev@gentoo.org mailing list