lkml.org 
[lkml]   [1999]   [Sep]   [27]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
Date
From
SubjectRe: [Q]: Linux and real device drivers
Jes Sorensen wrote:
>
> >>>>> "Jeff" == Jeff Garzik <jgarzik@pobox.com> 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.
If the stubs are inserted, then others, not just the original coders
can help to fill in the docs. I for one, seem to spend more time
writing docs than code lately, and **might** be able to help! It
would be real fun and a great learning experience -- you would
have to learn what the code does to document it!
--
W. Wade, Hampton <whampton@staffnet.com>

-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.rutgers.edu
Please read the FAQ at http://www.tux.org/lkml/

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