Messages in this thread | | | Date | Tue, 09 Oct 2007 08:47:16 +0200 | From | Stefan Richter <> | Subject | Re: RFC: reviewer's statement of oversight |
| |
> Sam Ravnborg wrote: >> On Tue, Oct 09, 2007 at 08:11:53AM +0200, Stefan Richter wrote: >>> The SCM changelog should contain _what_ a patch does and if >>> necessary _why_ it does so. >> The _why_ part is more important than _what_. The diff should hopefully >> explain the _what_ part. > > "What": fix lockup in this and that circumstances > "Why": because lockups are annoying > "How": the diff > (That's what I meant with what and why.)
PS, example with non-trivial why: What: add ABI which correlates bus cycle counter and local time Why: apps need it to sync streams from different buses How: the diff -- Stefan Richter -=====-=-=== =-=- -=--= http://arcgraph.de/sr/ - 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/
| |