From: Jeffrey Law <law@redhat.com>
To: Richard Kenner <kenner@vlsi1.ultra.nyu.edu>
Cc: dberlin@dberlin.org, bernds_cb1@t-online.de,
ebotcazou@libertysurf.fr, gcc@gcc.gnu.org,
sam@rfc1149.net, schwab@suse.de
Subject: Re: Rant about ChangeLog entries and commit messages
Date: Tue, 04 Dec 2007 22:10:00 -0000 [thread overview]
Message-ID: <1196805952.11808.20.camel@omfg.slc.redhat.com> (raw)
In-Reply-To: <10712031329.AA20246@vlsi1.ultra.nyu.edu>
On Mon, 2007-12-03 at 08:29 -0500, Richard Kenner wrote:
> > Sorry, but again, this is not a good enough justification to me.
> > We do a lot of things different than "The GNU Project".
> > So do plenty of parts of the "official GNU project".
> > They use different coding standards, bug tracking systems, version
> > control systems, checkin policies, etc, than each other.
>
> Yes, but none of those are visible other than to the development community.
> People who obtain the source distributions of projects don't get to see
> those things. They DO see things like the ChangeLog format and coding
> and documentation conventions and THOSE are the things that need to be
> common among GNU projects.
>
> In my view, ChangeLog is mostly "write-only" from a developer's
> perspective. It's a document that the GNU project requires us to produce
> for the benefit of people who DON'T want access to our checkin-logs, bug
> tracking information, and mailing lsits. But for our own development
> purposes, we use the above information much more than ChangeLog.
Right.
I don't necessarily want verbose ChangeLogs -- there are times I just
want to know what changed and who changed it. That's nice and easy to
extract from the ChangeLog.
Sometimes I want to look at the code/comments. Obviously I go to the
source to read those.
Sometimes I want even more information for a particularly complex
or controversial change -- in those cases I go back to the mailing list
archives and review the discussion(s) leading to changes to the code.
Each repository of information provides a different level of detail and
each (IMHO) has its place/utility.
Jeff
next prev parent reply other threads:[~2007-12-04 22:10 UTC|newest]
Thread overview: 79+ messages / expand[flat|nested] mbox.gz Atom feed top
2007-12-02 10:05 Samuel Tardieu
2007-12-02 10:23 ` Andreas Schwab
2007-12-02 10:52 ` Samuel Tardieu
2007-12-02 12:04 ` Hans-Peter Nilsson
2007-12-02 23:28 ` Robert Dewar
2007-12-03 0:30 ` DJ Delorie
2007-12-03 4:06 ` Richard Kenner
2007-12-03 4:51 ` Daniel Berlin
2007-12-03 14:41 ` Richard Kenner
2007-12-02 11:43 ` Samuel Tardieu
2007-12-02 12:28 ` Richard Kenner
2007-12-02 12:43 ` Bernd Schmidt
2007-12-02 13:05 ` Eric Botcazou
2007-12-02 14:27 ` Robert Kiesling
2007-12-02 20:52 ` tim
2007-12-03 2:41 ` Robert Kiesling
2007-12-02 23:29 ` Robert Dewar
2007-12-02 20:28 ` Daniel Berlin
2007-12-02 20:36 ` Eric Botcazou
2007-12-02 20:40 ` Daniel Berlin
2007-12-02 22:55 ` Eric Botcazou
2007-12-03 0:21 ` Daniel Berlin
2007-12-03 6:16 ` Eric Botcazou
2007-12-03 13:29 ` Richard Kenner
2007-12-03 15:48 ` Daniel Berlin
2007-12-03 16:20 ` Richard Kenner
2007-12-03 16:50 ` Robert Kiesling
2007-12-03 17:26 ` Robert Dewar
2007-12-04 22:10 ` Jeffrey Law [this message]
2007-12-16 3:03 ` Alexandre Oliva
2007-12-16 10:25 ` NightStrike
2007-12-16 13:04 ` Alexandre Oliva
2007-12-16 18:52 ` NightStrike
2007-12-25 19:35 ` Tim Josling
2007-12-26 1:05 ` Daniel Berlin
2007-12-26 2:17 ` Richard Kenner
2007-12-26 2:31 ` Robert Dewar
2007-12-26 4:53 ` Richard Kenner
2007-12-26 6:00 ` Alexandre Oliva
2007-12-02 20:59 ` tim
2007-12-02 23:32 ` Robert Dewar
2007-12-03 6:02 ` Eric Botcazou
2007-12-03 3:55 ` Richard Kenner
2007-12-02 23:31 ` Joseph S. Myers
2007-12-02 20:23 ` Daniel Berlin
2007-12-03 6:45 ` Nicholas Nethercote
2007-12-03 9:28 ` Andreas Schwab
2007-12-02 10:27 ` Eric Botcazou
2007-12-02 10:43 ` Samuel Tardieu
2007-12-02 10:50 ` Eric Botcazou
2007-12-02 11:14 ` Samuel Tardieu
2007-12-02 11:32 ` Eric Botcazou
2007-12-02 11:48 ` Samuel Tardieu
2007-12-02 12:25 ` Eric Botcazou
2007-12-02 23:03 ` Ben Elliston
2007-12-02 23:54 ` Daniel Jacobowitz
2007-12-03 4:03 ` Richard Kenner
2007-12-03 17:33 ` Diego Novillo
2007-12-03 17:37 ` Richard Kenner
2007-12-03 17:47 ` Bernd Schmidt
2007-12-03 17:58 ` Ian Lance Taylor
2007-12-03 18:20 ` Diego Novillo
2007-12-03 18:51 ` Richard Kenner
2007-12-03 18:58 ` Diego Novillo
2007-12-03 20:08 ` Tim Josling
2007-12-03 18:49 ` Richard Kenner
2007-12-04 16:45 ` Tom Tromey
2007-12-05 23:16 ` Ben Elliston
2007-12-05 23:35 ` Daniel Berlin
2007-12-06 0:29 ` Ben Elliston
2007-12-06 9:53 ` Andreas Schwab
2007-12-06 0:42 ` Robert Dewar
[not found] <2007-12-02-11-05-39+trackit+sam@rfc1149.net.suse.lists.egcs>
2007-12-02 18:33 ` Andi Kleen
[not found] ` <jeodd9l7j1.fsf@sykes.suse.de.suse.lists.egcs>
[not found] ` <Pine.GSO.4.61.0712031739500.10932@mulga.csse.unimelb.edu.au.suse.lists.egcs>
2007-12-03 12:20 ` Andi Kleen
2007-12-04 4:03 ` Nicholas Nethercote
2007-12-04 13:05 ` Richard Kenner
2007-12-04 10:19 ` Robert Kiesling
[not found] ` <200712022136.57819.ebotcazou@libertysurf.fr.suse.lists.egcs>
[not found] ` <4aca3dc20712021240k19f3eae5j66453276179c401a@mail.gmail.com.suse.lists.egcs>
[not found] ` <200712022355.23871.ebotcazou@libertysurf.fr.suse.lists.egcs>
[not found] ` <4aca3dc20712021621n39a036d2u21f471f231dfffe@mail.gmail.com.suse.lists.egcs>
[not found] ` <10712031329.AA20246@vlsi1.ultra.nyu.edu.suse.lists.egcs>
2007-12-03 16:34 ` Andi Kleen
2007-12-03 16:38 ` Richard Kenner
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=1196805952.11808.20.camel@omfg.slc.redhat.com \
--to=law@redhat.com \
--cc=bernds_cb1@t-online.de \
--cc=dberlin@dberlin.org \
--cc=ebotcazou@libertysurf.fr \
--cc=gcc@gcc.gnu.org \
--cc=kenner@vlsi1.ultra.nyu.edu \
--cc=sam@rfc1149.net \
--cc=schwab@suse.de \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).