Date: Mon, 19 Jan 2004 22:55:39 -0500 From: "Jonathan T. Sage" <sagejona@theatre.msu.edu> To: Al Johnson <haldoggie@hotmail.com> Cc: freebsd-questions@freebsd.org Subject: Re: FreeBSD Documentation and DocBook SGML Message-ID: <400CA6BB.3000007@theatre.msu.edu> In-Reply-To: <LAW12-F6hHVOTuBa0WC00014a28@hotmail.com> References: <LAW12-F6hHVOTuBa0WC00014a28@hotmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
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--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?400CA6BB.3000007>