[lkml]   [1999]   [Sep]   [27]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
Messages in this thread
SubjectRe: [Q]: Linux and real device drivers
>>>>> "Jeff" == Jeff Garzik <> writes:

Jeff> Jes Sorensen wrote:
>> I am not saying we cannot improve our documentation, I am merely
>> pointing out that we are dealing with volunteers and it is
>> unrealistic to expect them all to do documentation all the time
>> when hacking is so much more fun.

Jeff> No question about that ;)

Jeff> Any API docs are better than no API docs. Even simply adding
Jeff> stub API docs is very helpful, because that gives people a
Jeff> central place to look for a list of public functions they can
Jeff> use in their drivers and other code.

Actually I have to disagree strongly on this one, bad API docs are
worth than no docs since it is often misleading. That said, stub API
docs might be a good idea.

I am not sure I as a code hacker would want to do all the docs, it
might be an interesting project for people who care a lot about it, to
make this their pet project. I can see the people who write code often
being reluctant to actually writing the documentation themselves, but
it is generally quite easy to fool them into explaining their code if
you ask them ;-)


To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to
Please read the FAQ at

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