David Jones writes:
> > Speaking of the section 9 manual pages, WE NEED MORE.
> > 
> > Anyone who has a few minutes to document their favorite kernel
> > function or feature, please contribute a section 9 manual page! A
> > fully documented kernel means far more people will be able to get up
> > to speed on kernel hacking.
> 
> I would like to see documentation on the SCSI system, mainly to make sure
> that the Sun 5380 driver is implemented correctly.

Please write some! I would be very happy to add it in.

> Is there a section (subsection?) of man9 appropriate for documenting
> machine or chip-specific stuff, like the 5380 driver itself?

I'm not sure documentation on the innards of individual drivers is
needed, but I'll happily add some if it looks like it would give
people help in reading the drivers when using them as models on which
to write other such drivers. We can create architecture specific
subsection of section 9, after the model of other sections, if we need
to.

I would very much like, however, a man page giving an overview of how
drivers work in general -- such a thing would be a Big Win if it was
written properly.

Perry