From owner-freebsd-questions@FreeBSD.ORG Mon Jan 19 19:55:55 2004 Return-Path: Delivered-To: freebsd-questions@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 979CA16A4CE for ; Mon, 19 Jan 2004 19:55:55 -0800 (PST) Received: from theatre.msu.edu (theatre.msu.edu [35.8.69.30]) by mx1.FreeBSD.org (Postfix) with ESMTP id C69D343D62 for ; Mon, 19 Jan 2004 19:55:53 -0800 (PST) (envelope-from sagejona@theatre.msu.edu) Received: from theatre.msu.edu (c-67-167-140-34.client.comcast.net [67.167.140.34]) (authenticated bits=0) by theatre.msu.edu (8.12.10/8.12.10) with ESMTP id i0K3tZnV065119 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Mon, 19 Jan 2004 22:55:35 -0500 (EST) (envelope-from sagejona@theatre.msu.edu) Message-ID: <400CA6BB.3000007@theatre.msu.edu> Date: Mon, 19 Jan 2004 22:55:39 -0500 From: "Jonathan T. Sage" Organization: MSU Dept of Theatre User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.6b) Gecko/20031205 Thunderbird/0.4 X-Accept-Language: en-us, en MIME-Version: 1.0 To: Al Johnson References: In-Reply-To: X-Enigmail-Version: 0.82.6.0 X-Enigmail-Supports: pgp-inline, pgp-mime X-Phone: +1-517-974-1428 X-WWW-Home-Page: http://theatre.msu.edu X-PGP-Key-Figerprint: 182C CF3F 93A9 1DAA 2EBE D4D5 A159 96D9 452E A7F1 X-IM: AIM(jonathantsage,spartyman), ICQ(9587621), YIM(wisesage98) Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="------------enigAEA81D433076EE5A8CC80FF7" cc: freebsd-questions@freebsd.org Subject: Re: FreeBSD Documentation and DocBook SGML X-BeenThere: freebsd-questions@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: User questions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Jan 2004 03:55:55 -0000 This is an OpenPGP/MIME signed message (RFC 2440 and 3156) --------------enigAEA81D433076EE5A8CC80FF7 Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit Al Johnson wrote: > I'm learning about the FreeBSD documentation, and have read the > primer at: > http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/ > and have a question. > > http://www.freebsd.org/docproj/sgml.html > states: "The Documentation Project is trying to use SGML as the > standard method of representing the documentation." > > DocBook has been defined using both SGML and XML > (a subset of SGML). > > My question is: Why does the FreeBSD Documentation Project > prefer SGML to XML? > it's possible I'm reading things wrong, but it appears as those XML is a subset of SGML. While I am by no means an active docbook person, my guess would be the fact that in XML, a tree is required, (i.e., everything is a nest of a nest of a nest). I see very few instances where this would be all that appropriate for this sort of structure, particularly in a manual type format. While the term "outline" certinally works, ITEM1 - PREAMBLE is not the same significance as ITEM2 - CONFIGURATION, etc. XML forces a very rigid structure, where it looks like SGML is a bit more freeform. just my $0.02 ~j -- "Yesterday upon the stair I saw a man who wasn't there, he wasn't there again today, oh how i wish he'd go away" Jonathan T. Sage Theatrical Lighting / Set Designer Professional Web Design [HTTP://www.JTSage.com] [sagejona@theatre.msu.edu] [See Headers for Contact Info] --------------enigAEA81D433076EE5A8CC80FF7 Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (MingW32) Comment: Using GnuPG with Thunderbird - http://enigmail.mozdev.org iD8DBQFADKa+oVmW2UUup/ERAphmAJ9GbvTEiQmJbnp/zAL6pIz+pplAiACgmKve OiuNk8nzXHt2M+kO0EhN+Qc= =m474 -----END PGP SIGNATURE----- --------------enigAEA81D433076EE5A8CC80FF7--