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 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 ; Mon, 2 May 2011 01:37:44 +0000 (UTC) Received: by wwj40 with SMTP id 40so5206432wwj.10 for ; 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: 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 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: 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> From: Nirbheek Chauhan Date: Mon, 2 May 2011 07:07:23 +0530 X-Google-Sender-Auth: R_6JmbD9WMR7vPBF9tsfxQ-ZU6c Message-ID: 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 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