Re: Lets fix it! Re: kernel documentation is bad

Andries.Brouwer@cwi.nl
Wed, 23 Jul 1997 11:58:23 +0200


Stephen Williams:

:: What would be really helpful is a small man page for every function within
:: the kernel, and a few mino-howtos for some common driver writer tricks.
:: DDI man pages.

: amethyst@maxwell.ml.org said:
:: Speaking of which, why did LDP take away section 9?

: Who knows. Maybe we should re-introduce them... or make up our own set.

I removed man9 because there was extremely little,
and what was there was outdated or wrong.

Documenting single functions is hardly a worthwhile activity.
But `global' documentation is useful.

Man pages are not the right medium to convey
this type of information.

Andries