lkml.org 
[lkml]   [2002]   [May]   [13]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
Date
From
SubjectRe: Changelogs on kernel.org
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 bitmover.com http://www.bitmover.com/lm
-
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/

\
 
 \ /
  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