On Tue, Sep 13, 2005 at 03:47:19PM -0400, Jim Wise wrote: > -----BEGIN PGP SIGNED MESSAGE----- > Hash: SHA1 > > On Tue, 13 Sep 2005, Perry E. Metzger wrote: > > >I have to say I disagree. Often, in trying to debug one portion of the > >kernel or another, it is VERY valuable to understand the inside of how > >that portion of the kernel works. The 4.4 book is pretty old at this > >point and was woefully incomplete. > > I don't see a problem with keeping such documents, but it strikes me > that putting them in manual section 9 is an overloading of the meaning > of that section. > > If I am looking for a kernel API to do something in a driver, lkm, or > kernel change, and keep seeing promising-looking man pages which turn > out to be false leads as they document internal workings with no visible > (and thus usable) API, I'm likely to get frustrated. > > This doesn't mean we shouldn't keep such documentation, but I think it > _does_ mean such documents should go either in /usr/share/doc (my > preference), manual section 4 (perfectly reasonable) or in a new man > section. I think either /usr/share/doc or a new man section would be best. Take care, Bill
Attachment:
pgp3bdkIJ5YUF.pgp
Description: PGP signature