From owner-freebsd-doc@FreeBSD.ORG Sat Jul 31 15:58:47 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 9C4AB16A4CE for ; Sat, 31 Jul 2004 15:58:47 +0000 (GMT) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8CE9B43D6A for ; Sat, 31 Jul 2004 15:58:44 +0000 (GMT) (envelope-from marc@blackend.org) Received: from abigail.blackend.org (localhost [127.0.0.1]) i6VFwfxo010119; Sat, 31 Jul 2004 17:58:41 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: (from marc@localhost) by abigail.blackend.org (8.12.11/8.12.11/Submit) id i6VFwei7010118; Sat, 31 Jul 2004 17:58:40 +0200 (CEST) (envelope-from marc) Date: Sat, 31 Jul 2004 17:58:39 +0200 From: Marc Fonvieille To: Misoy Vines Message-ID: <20040731155839.GB3708@abigail.blackend.org> References: <200407312345.30746.edwin_vinas@pacific.net.ph> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <200407312345.30746.edwin_vinas@pacific.net.ph> User-Agent: Mutt/1.4.2.1i X-Useless-Header: blackend.org X-Operating-System: FreeBSD 4.10-PRERELEASE cc: doc@FreeBSD.org Subject: Re: inquiry X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 31 Jul 2004 15:58:47 -0000 On Sat, Jul 31, 2004 at 11:45:30PM +0800, Misoy Vines wrote: > hi, > > i'm impressed with the way the FreeBSD handbook really helps us freebsd users. > may i know what type of software you use in the documentation? > do you have a script or program that generates that html-based handbook? > The documentation is written in SGML/DocBook then converted to various formats: HTML, PDF etc. via Jade and other applications and some Makefiles. A meta-port allows you to install the required tools (textproc/docproj/) to build de docs.. If you CVSup the doc/ branch of the FreeBSD repository (see /usr/share/examples/cvsup/doc-supfile) you will get all documentation sources and Makefiles. http://www.bsdnews.org/02/freebsd_doc.php is a quick tutorial on Handbook compilation. http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/ will also give you a lot of informations. Marc