On Mon, Mar 13, 2000 at 04:47:21PM +0100, Giacomo Amabile Catenazzi wrote:
> Update documentation. (General)
> Update documentation. (most documents explain how to use/load modules,
> but many are wrong, old, incomplete or confusing a new user!
Yes. That is one of the main problems I have when trying to get some exotic
module loaded. For most of the time, I know the parameters by now - but
sometimes (e.g. NCR400a SCSI, which I never got to run properly) I had to
wade through the source - a real PITback.
I'd volunteer to help create (and maintain) a place (text file, most
probably) where developers put their README files for modules _including_
detailed parameter description and so on in a standard format (probably
something like the CREDITS file).
If there is any reason why we should be doing something else instead,
please let me know - I'd surely like to hear your better ideas.
But I think the current situation (README's scattered through the source
tree) is inacceptable for many people. Having to actually compile your own
kernel is a seldom task with todays' distros, so browsing the source itself
does not even occur to many people when looking for driver information.
--- 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/
This archive was generated by hypermail 2b29 : Wed Mar 15 2000 - 21:00:30 EST