From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from pigeon.gentoo.org ([208.92.234.80] helo=lists.gentoo.org) by finch.gentoo.org with esmtp (Exim 4.60) (envelope-from ) id 1QH0c2-0003B6-HQ for garchives@archives.gentoo.org; Mon, 02 May 2011 21:25:02 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 853581C065; Mon, 2 May 2011 21:24:53 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by pigeon.gentoo.org (Postfix) with ESMTP id 815761C005 for ; Mon, 2 May 2011 21:24:23 +0000 (UTC) Received: from [10.42.0.7] (nsg93-9-78-225-4-220.fbx.proxad.net [78.225.4.220]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) (Authenticated sender: eva) by smtp.gentoo.org (Postfix) with ESMTPSA id 489761B4019 for ; Mon, 2 May 2011 21:24:22 +0000 (UTC) Subject: Re: [gentoo-dev] Devmanual text on ChangeLogs From: Gilles Dartiguelongue To: gentoo-dev@lists.gentoo.org Date: Mon, 02 May 2011 23:24:09 +0200 In-Reply-To: <4DBBCC6D.7080504@gentoo.org> References: <4DBBCC6D.7080504@gentoo.org> Organization: Gentoo Content-Type: multipart/signed; micalg="pgp-sha1"; protocol="application/pgp-signature"; boundary="=-OHuFmYtVLX/LTCbR5Hiq" X-Mailer: Evolution 3.0.0 Message-ID: <1304371462.860.2.camel@keitaro> 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 X-Archives-Salt: X-Archives-Hash: fa521c4104216ed7bf708df8704b9757 --=-OHuFmYtVLX/LTCbR5Hiq Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Le samedi 30 avril 2011 =C3=A0 11:46 +0300, Petteri R=C3=A4ty a =C3=A9crit = : > http://devmanual.gentoo.org/ebuild-writing/misc-files/changelog/index.htm= l >=20 > There doesn't seem to be a common opinion on what the policy for > ChangeLog entries is. See: >=20 > http://archives.gentoo.org/gentoo-dev/msg_f829da2375f1ceab766a800913cc499= 8.xml >=20 > I propose a simple new text: "Every commit should have an entry in > ChangeLog." If we eventually autogenerate them from git logs this would > happen any way (unless some kind of filtering system is in the middle) > so we could already start now. I think it's better to have more than > less information available to users. >=20 > Regards, > Petteri >=20 As in any other open source project, history (even of removed files) matters just as much as the outcome. Please make it a policy to always have a ChangeLog entry for any changes. --=20 Gilles Dartiguelongue Gentoo --=-OHuFmYtVLX/LTCbR5Hiq Content-Type: application/pgp-signature; name="signature.asc" Content-Description: This is a digitally signed message part Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.17 (GNU/Linux) iEYEABECAAYFAk2/IPsACgkQ1fmVwcYIWAY85ACeKHrDUYciuGWfqpZoQzaNep3x HyAAnRKFMJggpgNiDH58XJQud5+Cutdl =juE5 -----END PGP SIGNATURE----- --=-OHuFmYtVLX/LTCbR5Hiq--