From mboxrd@z Thu Jan 1 00:00:00 1970 From: ludo@gnu.org (Ludovic =?utf-8?Q?Court=C3=A8s?=) Subject: Re: [PATCH 4/6] gnu: linux-libre-beagle-bone-black: Remove kernel variant. Date: Mon, 03 Oct 2016 17:40:41 +0200 Message-ID: <874m4tbfuu.fsf@gnu.org> References: <20160926103447.31830-1-david@craven.ch> <20160926103447.31830-4-david@craven.ch> <20160926132344.GA23258@jocasta.intra> <87wphv20hb.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:55796) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1br5MH-0006uD-Ib for guix-devel@gnu.org; Mon, 03 Oct 2016 11:40:50 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1br5ME-0006cG-Ba for guix-devel@gnu.org; Mon, 03 Oct 2016 11:40:49 -0400 In-Reply-To: (Vincent Legoll's message of "Mon, 3 Oct 2016 14:49:13 +0200") List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: Vincent Legoll Cc: guix-devel Hi, Vincent Legoll skribis: > On Wed, Sep 28, 2016 at 11:11 PM, Ludovic Court=C3=A8s wro= te: >> > > I read this and still am on the opposite side. > > The "changelog entries are like an undo list" is a WTF, to me this is what > `patch -R` is for... Not quite, because the change log shows the language-level view of the changes, which can be hard to infer by looking at a diff. It makes it easy to answer questions such as =E2=80=9Cwhen did we change this function?= =E2=80=9D, =E2=80=9Cwhen did we introduce that variable=E2=80=9D, etc. > My take on that (the newbie wanting to grasp it) is that I do the followi= ng: > - read git changelog entries titles in gitk (or a ML, or a gitweb) > - if oneliner title looks interesting for a subject I'm currently > trying to learn > - I read the full changelog entry > - if that is still interesting me, then I go read the code I see. The commit title is definitely what you=E2=80=99re interested in he= re. I understand it can be frustratingly short, but then again it=E2=80=99s no substitute for the full discussions or code explanations, IMO. > Is there something equivalent with the GNU-styled CLs, that does not requ= ire > me to read every patch ? Because that's not scaling very well, especially= in > languages that I'm not proficient in. > > My example is LKML, the changelogs are an extremely valuable tool to unde= rstand > things, to debug, etc... I just love this level of details put into chang= elogs. AIUI Linux-style commit logs are not change logs, but explanations. I still strongly believe that explanations believe in code. Ludo=E2=80=99.