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 1QGEhG-0000DK-JF for garchives@archives.gentoo.org; Sat, 30 Apr 2011 18:15:14 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id EAA2C1C01F; Sat, 30 Apr 2011 18:15:05 +0000 (UTC) Received: from mail-wy0-f181.google.com (mail-wy0-f181.google.com [74.125.82.181]) by pigeon.gentoo.org (Postfix) with ESMTP id 0789C1C004 for ; Sat, 30 Apr 2011 18:14:37 +0000 (UTC) Received: by wyi11 with SMTP id 11so4684591wyi.40 for ; Sat, 30 Apr 2011 11:14:37 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:sender:date:from:to:subject:message-id :references:mime-version:content-type:content-disposition :in-reply-to:user-agent; bh=bQEjSyOm2JRex6CZzo5L8ufuuRF1jpeF7VJYj7Hsu6c=; b=LyKYUFgsW5Vun9D66sOqBy9QufdhX9aOZF4/evn4tv+/j2kHswJDzy5haFMk9/hYf8 U2jaP8lEYZwgJ7jWNAN2Gv03uZdHaBC73vZMTot0E3L1aW+XTJJpqYbuipM8NomTuSS9 kKUlVcB3IQbRVdEyYKz37fW0jzjZ3ir8+CVMU= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=sender:date:from:to:subject:message-id:references:mime-version :content-type:content-disposition:in-reply-to:user-agent; b=nWzKcbeCptOXWSj7UYdAAWcU7p5NVhriH3r/QDjcMNlc/JBZEq+iBKyv5wdNn3jt/q JGp11Ui/cSQ0wrV/jbQzfTr6mFl9Zh9uXZ0KuPkRN0gobNjsg1zXZC+2CwuK1hflnynO SRN5l2wWp7xYVYjFRONiRpdU8bxCMGC5uZ+aw= Received: by 10.227.37.12 with SMTP id v12mr874410wbd.20.1304187275434; Sat, 30 Apr 2011 11:14:35 -0700 (PDT) Received: from lust (ppp079166174138.dsl.hol.gr [79.166.174.138]) by mx.google.com with ESMTPS id ed10sm2393209wbb.15.2011.04.30.11.14.33 (version=TLSv1/SSLv3 cipher=OTHER); Sat, 30 Apr 2011 11:14:34 -0700 (PDT) Sender: Alex Alexander Date: Sat, 30 Apr 2011 21:16:20 +0300 From: Alex Alexander To: gentoo-dev@lists.gentoo.org Subject: Re: [gentoo-dev] Devmanual text on ChangeLogs Message-ID: <20110430181620.GA20395@lust> References: <4DBBCC6D.7080504@gentoo.org> <4DBBD02B.3060909@gentoo.org> <20110430134208.GA12304@Eternity.halls.manchester.ac.uk> 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 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="M9NhX3UHpAaciwkO" Content-Disposition: inline In-Reply-To: <20110430134208.GA12304@Eternity.halls.manchester.ac.uk> User-Agent: Mutt/1.5.21 (2010-09-15) X-Archives-Salt: X-Archives-Hash: 75b4204b9beb9c80efdf4915166a9f1d --M9NhX3UHpAaciwkO Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sat, Apr 30, 2011 at 02:42:08PM +0100, Markos Chandras wrote: > On Sat, Apr 30, 2011 at 12:02:35PM +0300, Samuli Suominen wrote: > > On 04/30/2011 11:46 AM, Petteri R=E4ty wrote: > > > http://devmanual.gentoo.org/ebuild-writing/misc-files/changelog/index= =2Ehtml > > >=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_f829da2375f1ceab766a800913c= c4998.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 wou= ld > > > 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 > >=20 > > "Every new file, and modification to existing file should have an entry > > in ChangeLog." to skip the proper ChangeLog-less removals. > >=20 > I am actually with Samuli on this. Unless there is a particular reason > for removing a package, I don't see any point of documenting this change = anywhere. > What difference would it make to you if you see an entry " -foo-1.0 > old". It makes absolutely no sense. There are times when you need to know where a version went. That alone is enough to warrant updating the ChangeLog. Having to check a second place through a slow interface sucks :) --=20 Alex Alexander | wired + Gentoo Linux Developer ++ www.linuxized.com --M9NhX3UHpAaciwkO Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.17 (GNU/Linux) iQIcBAEBCAAGBQJNvFH0AAoJEDZF8K7rm0r6DrMQALNn0FX76U1oQwmVivr/tmgE OtzCANW57aB2e/a9oigobgsxsbrk6OgU4DT9umicQlH3sM36bHoMoS1yY/uNVeMI 950eyL6IaS4ccrK9KkZAlzJCdDJLS7CBqFtjVYZNlRUzyi9CN/ZoXq4cNd5cecEx /rCdje7/mYjFv3zEDXy3S+hJ3hfhuZKtKZOD6h2o3jT0H9ehjPYg8DVDpxzovUOf vH4VF+60IRkb+bnV/AqsObholkmfctK0xPPBTfuu2cH30Tp2cSCEuRe/i1MP3ryd jzuKE8UK+qjC9tsPUVJT9MYU4K+TEntohly5zqqlt9+TQ0wuVEZyxBG6OrMZ/rGX 2/mML5q3Zb83a6NyV+wL1DsanYJ7hiE1R27VFdqqSVnH4ypUTR4XoXv5KgXaQaxk /GhfPzqtnXGYnJll6k/TzlqPGyN5IlQ1KrIPJ/AMDxLqlO0NfcNJioiLH8AFFS0Y Kmsi/92oTCreYjrm0KrvK2Gofx66fwpvg9gndpi3owaQ1DY84UOg9Psgukt0SsBq tN+RyA63zAks0Zr+m3mmWjeR7s6eC+ksAzSxJit5RtcwDinzpgDZ36M2hGQYPc5H s45RiUfIcFMcQbnVPJnH9elA3g+p/whT19+rsAXfMrFZOWNz2J0E1KtgNwTfj12c JMaLxARz4SoZc2J+7hl6 =c0MF -----END PGP SIGNATURE----- --M9NhX3UHpAaciwkO--