Date: Fri, 15 Jan 2010 10:43:44 +0100 (CET)
From: Julia Lawall <julia@diku.dk>
To: David Miller <davem@davemloft.net>
Cc: stefanr@s5r6.in-berlin.de, adi@hexapodia.org, nm127@freemail.hu,
        david.vrabel@csr.com, linux-usb@vger.kernel.org,
        linux-kernel@vger.kernel.org, cocci@diku.dk
Subject: Re: Changelog quality
In-Reply-To: <20100115.012233.202457727.davem@davemloft.net>
Message-ID: <Pine.LNX.4.64.1001151039080.23543@ask.diku.dk>
References: <4B502C6B.7000802@s5r6.in-berlin.de> <20100115.005445.263291449.davem@davemloft.net>
 <tkrat.e88dd4dbf17f9bde@s5r6.in-berlin.de> <20100115.012233.202457727.davem@davemloft.net>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: linux-kernel-owner@vger.kernel.org

> If you want more clear markers around the script so you can skim
> past it more efficiently when reading the commit message, then ask
> for that.

If there were markers that would cause tools to hide some information 
under a +, that would be great.  Sometimes I have simplified a script 
beyond what would really be reusable just to not create an over-large 
changelog.  I hope that the simplified version is at least understandable, 
so that the reader can get an idea of what considerations went into the 
change, but I recall in one case having messed up on that as well, and 
ended up with something that really gave no information whatsoever.

julia
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/