Date: Sun, 24 Sep 2006 20:22:14 +0200 From: Marc Fonvieille <blackend@freebsd.org> To: Duane Whitty <duane@dwlabs.ca> Cc: freebsd-doc@freebsd.org Subject: Re: man pages and handbooks Message-ID: <20060924182214.GA2650@gothic.blackend.org> In-Reply-To: <4516C36B.7030701@dwlabs.ca> References: <20060905223444.GA33935@dwpc.dwlabs.ca> <20060924070721.GA961@gothic.blackend.org> <4516C36B.7030701@dwlabs.ca>
next in thread | previous in thread | raw e-mail | index | archive | help
On Sun, Sep 24, 2006 at 02:42:03PM -0300, Duane Whitty wrote: [...] > > > > >If you want to just merge/copy some manual pages parts in the > >arch-handbook then you miss the point since there's no gain in > >duplicating the information. For example if you want to talk about the > >ULE schedule we are not looking for a sched_ule(4) manual page copy but > >a documented text covering the features, how to use it or code with it, > > I agree. > > >etc.; another example would be the USB devices, if your look at the > >current chapter, the text explain how the USB stack works (it's quite > >the case) but miss a part explaining how to write a simple USB (HID?) > >driver. > > I somewhat agree but I also don't believe that the > Architecture Handbook is the best location for detailed > tutorial information on how to develop for a specific > subsystem; Just my opinion. Is that not be what the > Developers' Handbook is for? [Not meant as a rhetorical > question] > [...] The Developers Handbook is for people who want to develop under FreeBSD, the Arch Handbook is for people who want to develop or understand FreeBSD internals. Just read, as example, http://www.freebsd.org/doc/en_US.ISO8859-1/books/arch-handbook/devicedrivers.html etc. Marc
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20060924182214.GA2650>