From owner-freebsd-doc Tue Apr 11 20:26: 0 2000 Delivered-To: freebsd-doc@freebsd.org Received: from sanson.reyes.somos.net (freyes.static.inch.com [216.223.199.224]) by hub.freebsd.org (Postfix) with ESMTP id C34F837BAE7; Tue, 11 Apr 2000 20:25:54 -0700 (PDT) (envelope-from fran@sanson.reyes.somos.net) Received: from tomasa (tomasa.reyes.somos.net [10.0.0.11]) by sanson.reyes.somos.net (8.9.3/8.9.3) with SMTP id XAA26888; Tue, 11 Apr 2000 23:21:50 -0400 (EDT) (envelope-from fran@sanson.reyes.somos.net) Message-Id: <200004120321.XAA26888@sanson.reyes.somos.net> From: "Francisco Reyes" To: "doc@FreeBSD.ORG" , "Nik Clayton" Date: Tue, 11 Apr 2000 23:19:26 -0400 Reply-To: "Francisco Reyes" X-Mailer: PMMail 2000 Professional (2.10.2010) For Windows 98 (4.10.2222) In-Reply-To: <20000412013455.A23096@catkin.nothing-going-on.org> MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit Subject: Re: Structuring the Developer Handbook Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed, 12 Apr 2000 01:34:55 +0100, Nik Clayton wrote: >http://people.freebsd.org/~nik/developer-handbook/index.html (or /book.html >if you want one big file) shows a very early cut at how the Developer >Handbook might be structured. It includes some content culled from the >current Handbook. So far the site seems more of an architectural "overview" than a "developer's handbook". I think there are many basic pieces of info which would be helpful on this site. Some suggestions. -Add a section of what comes with FreeBSD out of the Box. Yes this should be common knowledge for someone who has been using FreeBSD, but not for newcomers. In particular a reference to look at the languages ports (or other relevant port categories) would be very benefitial. -Sections on creating ports and packages. -Mention header files/make files which are used by programs when compiling under FreeBSD. This is important in particular for port developers. -Do a quick overview of where sources reside, both userland and Kernel. -Explain how to submit enhancements and fixes. -Talk about the CVS repository -Pointer to CVSup on the current Handbook or pointer to the Cvsup URL. Some of these suggestions may not seem "techie" enough, but getting to know the environment where one is going to program is just as needed as having details about kernel, libraries and such. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message