inquiry

[Marc Fonvieille]

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