From owner-freebsd-doc@FreeBSD.ORG Sun Mar 20 17:01:02 2005 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 5EF4B16A4CE for ; Sun, 20 Mar 2005 17:01:02 +0000 (GMT) Received: from smtpout.mac.com (smtpout.mac.com [17.250.248.72]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2059743D54 for ; Sun, 20 Mar 2005 17:01:02 +0000 (GMT) (envelope-from cswiger@mac.com) Received: from mac.com (smtpin01-en2 [10.13.10.146])j2KH10WP001902; Sun, 20 Mar 2005 09:01:01 -0800 (PST) Received: from [192.168.1.6] (pool-68-161-53-96.ny325.east.verizon.net [68.161.53.96]) (authenticated bits=0)j2KH0wJR028885; Sun, 20 Mar 2005 09:00:59 -0800 (PST) In-Reply-To: <1111337411_349@smtp.smartwilly.com> References: <1111337411_349@smtp.smartwilly.com> Mime-Version: 1.0 (Apple Message framework v619.2) Content-Type: text/plain; charset=US-ASCII; format=flowed Message-Id: <3f1e0f887315fe4ab71ce0f92224b3fe@mac.com> Content-Transfer-Encoding: 7bit From: Charles Swiger Date: Sun, 20 Mar 2005 12:00:57 -0500 To: Lorne G X-Mailer: Apple Mail (2.619.2) cc: doc@FreeBSD.org Subject: Re: Documentation Tools 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: Sun, 20 Mar 2005 17:01:02 -0000 Hi, Lorne-- On Mar 20, 2005, at 11:48 AM, Lorne G wrote: > I would like to know if you use a particular tool to create the online > documentation or if you write the html manually. I would like to start > creating documentation like the handbook for my projects. I would like > to > know if you use a tool that manages the table of contents and the > next|prev > buttons for each section. Thanks very much for your help. The FreeBSD documentation is largely written in SGML using a set of tools described here: http://www.freebsd.org/doc/en/books/fdp-primer/ This'll show you have to set up the tools, create your own articles, as well as how to contribute documentation changes back to FreeBSD. -- -Chuck