From owner-freebsd-doc@FreeBSD.ORG Mon Sep 21 00:52:09 2009 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 964EE106566B for ; Mon, 21 Sep 2009 00:52:09 +0000 (UTC) (envelope-from lgusenet@be-well.ilk.org) Received: from mail7.sea5.speakeasy.net (mail7.sea5.speakeasy.net [69.17.117.9]) by mx1.freebsd.org (Postfix) with ESMTP id 3B5878FC2D for ; Mon, 21 Sep 2009 00:52:09 +0000 (UTC) Received: (qmail 21163 invoked from network); 21 Sep 2009 00:41:45 -0000 Received: from dsl092-078-145.bos1.dsl.speakeasy.net (HELO be-well.ilk.org) ([66.92.78.145]) (envelope-sender ) by mail7.sea5.speakeasy.net (qmail-ldap-1.03) with SMTP for ; 21 Sep 2009 00:41:44 -0000 Received: from lowell-desk.lan (lowell-desk.lan [172.30.250.6]) by be-well.ilk.org (Postfix) with ESMTP id 83DE8508A8; Sun, 20 Sep 2009 20:41:35 -0400 (EDT) Received: by lowell-desk.lan (Postfix, from userid 1147) id E5C3B1CC2B; Sun, 20 Sep 2009 20:41:34 -0400 (EDT) From: Lowell Gilbert To: iqgrande@gmail.com (Anthony Michael Agelastos) References: Date: Sun, 20 Sep 2009 20:41:34 -0400 In-Reply-To: (Anthony Michael Agelastos's message of "Sun, 20 Sep 2009 20:08:48 -0400") Message-ID: <44pr9lxh6p.fsf@lowell-desk.lan> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.1 (berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Cc: freebsd-doc@freebsd.org Subject: Re: Superb documentation X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 21 Sep 2009 00:52:09 -0000 iqgrande@gmail.com (Anthony Michael Agelastos) writes: > I've been a long-time user of FreeBSD partially due to the superb > documentation it provides. Anyways, I am curious about how this > documentation is built. I am a n00b when it comes to this sort of > thing, but it appears that you use DocBook and some style sheets to > auto-generate and auto-format the documentation. I am familiar with > the concept of DocBook since I use LaTeX but am not even sure where to > begin even attempting it. Do you have any recommended pieces of > software that help in speeding things along? What software do you use > to create the final document? Thank you for your insight into this. Have you looked at the documentation for building the documentation? http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/index.html