From owner-freebsd-doc Mon May 20 6:56:51 2002 Delivered-To: freebsd-doc@freebsd.org Received: from south.nanolink.com (south.nanolink.com [217.75.134.10]) by hub.freebsd.org (Postfix) with SMTP id E6C4937B409 for ; Mon, 20 May 2002 06:56:43 -0700 (PDT) Received: (qmail 23811 invoked by uid 85); 20 May 2002 14:04:59 -0000 Received: from unknown (HELO straylight.ringlet.net) (212.116.140.125) by south.nanolink.com with SMTP; 20 May 2002 14:04:54 -0000 Received: (qmail 51676 invoked by uid 1000); 20 May 2002 13:55:55 -0000 Date: Mon, 20 May 2002 16:55:55 +0300 From: Peter Pentchev To: Ross Lippert Cc: keramida@FreeBSD.ORG, freebsd-doc@FreeBSD.ORG Subject: Re: Problem Report docs/31653 Message-ID: <20020520165555.A349@straylight.oblivion.bg> Mail-Followup-To: Ross Lippert , keramida@FreeBSD.ORG, freebsd-doc@FreeBSD.ORG References: <20020520001522.GB3205@hades.hell.gr> <200205201340.GAA29968@eskimo.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-md5; protocol="application/pgp-signature"; boundary="UugvWAfsgieZRqgk" Content-Disposition: inline User-Agent: Mutt/1.2.5.1i In-Reply-To: <200205201340.GAA29968@eskimo.com>; from ripper@eskimo.com on Mon, May 20, 2002 at 06:40:37AM -0700 X-Virus-Scanned: by Nik's Monitoring Daemon (AMaViS perl-11d) Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org --UugvWAfsgieZRqgk Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Mon, May 20, 2002 at 06:40:37AM -0700, Ross Lippert wrote: >=20 >=20 > I'm looking through the handbook right now and it appears that all > the documents are generated with docbook. Where can I find the sgml > sources, and what it the recommended way of producing and validating > new docs? Take a look at http://www.FreeBSD.org/docproj/ - the 'SGML and the Documentation Project' link explains the basics of the SGML used in the FreeBSD Documentation Project. There is also a link there to the FreeBSD Doc Project Primer at http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/index.html As to obtaining the Handbook sources, the best way to do that would be CVSup. Just pull down the 'doc' collection, and you have the SGML sources to all the books and articles, as well as the build infrastructure needed to build and install them all by issuing a 'make all install' command. Of course, you can build any single article and book, too, by using 'make' (possibly followed by a 'make install') in its own subdirectory. Hope that helps! If you have any more questions, do not hesitate to ask. We are always happy to welcome a new contributor! :) G'luck, Peter --=20 Peter Pentchev roam@ringlet.net roam@FreeBSD.org PGP key: http://people.FreeBSD.org/~roam/roam.key.asc Key fingerprint FDBA FD79 C26F 3C51 C95E DF9E ED18 B68D 1619 4553 If this sentence didn't exist, somebody would have invented it. --UugvWAfsgieZRqgk Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.7 (FreeBSD) iD8DBQE86QBq7Ri2jRYZRVMRAkOiAJ9tV7p1fskNAPOJNm0eGthdshZ4pwCeJjdJ qG7tp6jgefLSTTQNS4JhcvM= =K3Vr -----END PGP SIGNATURE----- --UugvWAfsgieZRqgk-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message