[lkml]   [2002]   [May]   [13]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
Messages in this thread
SubjectRe: Changelogs on
On Mon, May 13, 2002 at 01:10:06AM -0400, Jeff Garzik wrote:
> (speaking more to the crowd...)
> Changeset comments need to be written as if they stand alone, without
> any other context -- including the author. A reader should not need to
> know that (for examples) James Simmons hacks on fbdev stuff.

100% agreed.

Part of the design of citool was an attempt to guide people towards
doing that. We encourage people to do the detailed stuff on the file
comments and the logical level comment on the changeset. Think of file
as the "how" and the changeset as the "what".

The good news is that people do tend to get better once they realize
that other people read this stuff.
Larry McVoy lm at
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to
More majordomo info at
Please read the FAQ at

 \ /
  Last update: 2005-03-22 13:26    [W:0.076 / U:1.208 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site