Re: [patch 6/7] Linux Kernel Markers - Documentation

[Randy Dunlap <randy.dunlap@oracle.com>]

Christoph Hellwig wrote:
> On Mon, Sep 24, 2007 at 11:23:35AM -0700, Randy Dunlap wrote:
>> That might be OK for this case, but sometimes it makes sense to have
>> README etc. about how to use the software.  So you would want this
>> in the Documentation/ tree?  That makes it harder on users.
> 
> If it's so complex that we can't describe it in a few dozens lines
> it shouldn't be anywhere but the place it belongs and better have a
> real use and not just be a sample.  And in the trace case I must
> admit that I'd prefer a real use like some simple syscall-trace
> over this hack anyway..

I think that samples are perfectly fine for documentation and
that the trace example is a good example.  I think that most people
who need something like that would need to customize it for their
specific needs anyway.

We don't seem to be making progress...


-- 
~Randy
Phaedrus says that Quality is about caring.