From owner-freebsd-doc@FreeBSD.ORG  Mon Sep 21 00:29:37 2009
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 66A40106566B
	for <doc@freebsd.org>; Mon, 21 Sep 2009 00:29:37 +0000 (UTC)
	(envelope-from iqgrande@gmail.com)
Received: from mail-yx0-f172.google.com (mail-yx0-f172.google.com
	[209.85.210.172])
	by mx1.freebsd.org (Postfix) with ESMTP id 1D0A48FC1B
	for <doc@freebsd.org>; Mon, 21 Sep 2009 00:29:37 +0000 (UTC)
Received: by yxe2 with SMTP id 2so3044916yxe.3
	for <doc@freebsd.org>; Sun, 20 Sep 2009 17:29:36 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma;
	h=domainkey-signature:received:received:subject:from:content-type
	:message-id:date:to:content-transfer-encoding:mime-version:x-mailer;
	bh=ta2QI2WAPNg8lZnNOikVvVTBkSTx/vEEN2KAAzaRcd8=;
	b=imZ4tZPBUaSMuWXwNHzZEDHVeWB0ld2PQWjs1E8ttTbGJ3Xz9kbpS7co3btcaE1q/e
	qSxDSSpY4HOW8yqVzMpcKX/tf8GhnmuviiG6fXF8PMRX8Oq/T/mjUho6UAcwBO3FkII1
	PvxF1V8guulZ3y7K2MNNYDyxDU9Urt71SeJXI=
DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma;
	h=subject:from:content-type:message-id:date:to
	:content-transfer-encoding:mime-version:x-mailer;
	b=Kf9+MOoYOahlievDKWoLPQv/Q7uG/wH/Twc9PtksNjJ3xVs43mQpBmbP7JfTi2WGul
	HBsob6tCRgER+w4ynYe16HvzmnI5T/1mD724xIipQ1dvup0mcll3ObulDBbXflF9Eqzz
	0aKygGLJZTviU5c94VDMPsz5RT0gi8Wxxc17Y=
Received: by 10.90.22.2 with SMTP id 2mr2898722agv.104.1253491729702;
	Sun, 20 Sep 2009 17:08:49 -0700 (PDT)
Received: from ?192.168.0.4? (c-71-204-23-81.hsd1.ga.comcast.net
	[71.204.23.81])
	by mx.google.com with ESMTPS id 7sm3594273agb.1.2009.09.20.17.08.48
	(version=TLSv1/SSLv3 cipher=RC4-MD5);
	Sun, 20 Sep 2009 17:08:49 -0700 (PDT)
From: Anthony Michael Agelastos <iqgrande@gmail.com>
Content-Type: text/plain; charset=us-ascii; format=flowed; delsp=yes
Message-Id: <BF7F9E48-23DB-4375-B77D-989DB9676BD2@gmail.com>
Date: Sun, 20 Sep 2009 20:08:48 -0400
To: doc@FreeBSD.org
Content-Transfer-Encoding: 7bit
Mime-Version: 1.0 (Apple Message framework v1076)
X-Mailer: Apple Mail (2.1076)
Cc: 
Subject: Superb documentation
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 21 Sep 2009 00:29:37 -0000

Hello,

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.

Regards,

Anthony