Date: Fri, 30 Dec 2011 10:22:31 -0500 From: David Jackson <djackson452@gmail.com> To: Robert Bonomi <bonomi@mail.r-bonomi.com>, freebsd-questions@freebsd.org Subject: Re: FreeBSD Kernel Internals Documentation Message-ID: <CAGy-%2Bi-m7hUfrUPKaG6FAiv8cor6%2BWXUW-OwWA=uOAt0yDToag@mail.gmail.com> In-Reply-To: <201112300604.pBU64dqB069626@mail.r-bonomi.com> References: <CAGy-%2Bi-NN_SOYrrE6WgHyCBa5VzFexwT_C9UYhO3GyjvfsxpAA@mail.gmail.com> <201112300604.pBU64dqB069626@mail.r-bonomi.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On Fri, Dec 30, 2011 at 1:04 AM, Robert Bonomi <bonomi@mail.r-bonomi.com>wrote: > > From owner-freebsd-questions@freebsd.org Thu Dec 29 21:46:36 2011 > > Date: Thu, 29 Dec 2011 22:43:16 -0500 > > From: David Jackson <djackson452@gmail.com> > > To: freebsd-questions@freebsd.org > > Subject: FreeBSD Kernel Internals Documentation > > > > I have had an interest in studying the FreeBSD kernel and getting to know > > its internals better. After all, in Open source projects, they say, > > community contributions are important. > > > > However, My finding is that due to poor documentation, the FreeBSD kernel > > is nearly impenetrable to an outsider. I have been able to find no > > comprehensive documentation of kernel internals. I have found it nearly > > impossible, due to lack of comprehensive documentation, much of any of > the > > kernel internals. What I see is an internal cliche of developers who are > > aware of its myraid of undocumented esoteric secrets, and very little to > > actually help anyone else to understand it. > > You're talking abaout _volumes_ of documentation, literally many books > worth. > > Start with "The Design and Implementation of the BSD 4.4.4 Operating > System" > by McKusick, eal. > > Then read "The design and Implementation of the FreeBSD Operating System", > by McKusick and Neville-Neal.` > > > *You* are free to contribute 'better documentation' as you review any > particular file. Since you feel it is important, you are strongly > encouraged to "do something" to actually 'make it better', as opposed > to merely sitting on the sidelines and sniping at the work of others. > > Well, okay, yes, I have heard of these books. Of course, if I am getting involved in studying and figuring out the FreeBSD kernel, I would contribute documentation, both for my own future use and for the benefit of others. Of course, those best able to document are those who wrote it in the first place, since they already know how it works.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAGy-%2Bi-m7hUfrUPKaG6FAiv8cor6%2BWXUW-OwWA=uOAt0yDToag>