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 <gentoo-dev+bounces-45620-garchives=archives.gentoo.org@lists.gentoo.org>)
id 1QGi5f-0003Mp-Cs
for garchives@archives.gentoo.org; Mon, 02 May 2011 01:38:23 +0000
Received: from pigeon.gentoo.org (localhost [127.0.0.1])
by pigeon.gentoo.org (Postfix) with SMTP id 9ADB81C0CD;
Mon, 2 May 2011 01:38:13 +0000 (UTC)
Received: from mail-ww0-f53.google.com (mail-ww0-f53.google.com [74.125.82.53])
by pigeon.gentoo.org (Postfix) with ESMTP id 164EB1C04A
for <gentoo-dev@lists.gentoo.org>; Mon, 2 May 2011 01:37:44 +0000 (UTC)
Received: by wwj40 with SMTP id 40so5206432wwj.10
for <gentoo-dev@lists.gentoo.org>; Sun, 01 May 2011 18:37:44 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=gmail.com; s=gamma;
h=domainkey-signature:mime-version:sender:in-reply-to:references:from
:date:x-google-sender-auth:message-id:subject:to:content-type;
bh=VEIfYKqXLVdlNCo/L6ynzaHQlIl6OUflXdv69bUp69E=;
b=sLEhImMb2GK6a5x+7fNh8mnT4rJ0mB+xaFBCuTgwRHEM7YbfssxZn/E+s0fBJ6r2Mq
Pq4TwAt9hapAIrJnugUhedRl4MZR6RmgViJnH/3QQoViWySxHsaDncR098UrmIL0s82x
6j2zj1aR6BSMoeUyx6nLDYpgEqKyZXLK4HLxA=
DomainKey-Signature: a=rsa-sha1; c=nofws;
d=gmail.com; s=gamma;
h=mime-version:sender:in-reply-to:references:from:date
:x-google-sender-auth:message-id:subject:to:content-type;
b=QCjqSjgcxWfMnH1DtVg09ceZYHvPETRcfJcJjwmkdlQ5ExeDHkt8oueS+Nayl2y+8+
KRajm0+I0a0qSoSbVKsJrgJ0iOawltCFdsoadQazKb5HdJlZ58MZiwUg4BX4Me3oiHuF
Vh0Y01byei4a8FXEIzSyDK6HXeKr8+GTQ509Q=
Received: by 10.216.209.212 with SMTP id s62mr4511383weo.67.1304300264084;
Sun, 01 May 2011 18:37:44 -0700 (PDT)
Precedence: bulk
List-Post: <mailto:gentoo-dev@lists.gentoo.org>
List-Help: <mailto:gentoo-dev+help@lists.gentoo.org>
List-Unsubscribe: <mailto:gentoo-dev+unsubscribe@lists.gentoo.org>
List-Subscribe: <mailto:gentoo-dev+subscribe@lists.gentoo.org>
List-Id: Gentoo Linux mail <gentoo-dev.gentoo.org>
X-BeenThere: gentoo-dev@lists.gentoo.org
Reply-to: gentoo-dev@lists.gentoo.org
MIME-Version: 1.0
Sender: nirbheek.chauhan@gmail.com
Received: by 10.216.187.85 with HTTP; Sun, 1 May 2011 18:37:23 -0700 (PDT)
In-Reply-To: <robbat2-20110502T012334-624375518Z@orbis-terrarum.net>
References: <4DBBCC6D.7080504@gentoo.org> <20110501100017.GE24801@gentoo.org>
<20110501210831.GA2816@Eternity.halls.manchester.ac.uk> <19901.62761.450007.418544@a1i15.kph.uni-mainz.de>
<BANLkTin4CvaOef9C0g=dSgmP1JQZC7Z_nw@mail.gmail.com> <robbat2-20110502T012334-624375518Z@orbis-terrarum.net>
From: Nirbheek Chauhan <nirbheek@gentoo.org>
Date: Mon, 2 May 2011 07:07:23 +0530
X-Google-Sender-Auth: R_6JmbD9WMR7vPBF9tsfxQ-ZU6c
Message-ID: <BANLkTi=U4fEfMAZjwEkZSz1YN08wEQ+Yeg@mail.gmail.com>
Subject: Re: [gentoo-dev] Devmanual text on ChangeLogs
To: gentoo-dev@lists.gentoo.org
Content-Type: text/plain; charset=UTF-8
X-Archives-Salt:
X-Archives-Hash: 5fbceb8cbc010fb288d672b065792929
On Mon, May 2, 2011 at 6:54 AM, Robin H. Johnson <robbat2@gentoo.org> wrote:
> On Mon, May 02, 2011 at 06:50:01AM +0530, Nirbheek Chauhan wrote:
>> I don't get why someone would want to edit ChangeLogs. Could you list
>> some use-cases besides editing of typos?
> One that I have seen before was the change of a URL for users to migrate
> their data, when upstream changed the URL. The URL in question was in
> the ebuild and the changelog.
>
This is not a case for editing of ChangeLogs. I see three standard
ways for this information to be conveyed, in decreasing order of
likelihood of the user reading it:
(1) A Gentoo news file
(2) The ebuild itself via elog/ewarn
(3) The ChangeLog entry which changed the URL in the ebuild
In any case, ChangeLogs have always been historical records of the
changes that occurred in a package. What people seem to want is a
hybrid of ChangeLogs and NEWS files. I don't see how the costs of this
(inevitable merge conflicts, duplicated information, increased git
tree size) outweigh the benefits (the rare user who looks at the
ChangeLog but not the ebuild).
--
~Nirbheek Chauhan
Gentoo GNOME+Mozilla Team