Subject: Re: why XML?
To: NetBSD Documentation Discussion List <netbsd-docs@NetBSD.org>
From: Greg A. Woods <woods@planix.com>
List: netbsd-users
Date: 04/01/2007 19:25:32
--pgp-sign-Multipart_Sun_Apr__1_19:25:31_2007-1
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: quoted-printable

At Mon, 2 Apr 2007 00:41:53 +0200 (CEST), Mark Weinem wrote:
Subject: Re: why XML?=20
>=20
> How about "AsciiDoc"? It can produce HTML, PDF and DocBook document
> types.
>=20
>  	http://www.methods.co.nz/asciidoc/index.html

AsciiDoc reminds me far too much of being the same kind of hack as Henry
Spencer's AWF is:

	http://www.isc.org/sources/utils/text/awf.php

If one wants clearly readable, easily maintained, easily parsed,
structured documents suitable from everything from business cards to
entire books, then Lout really is the best thing I've seen to date (and
I've been looking at and for such tools for decades now).

HOWEVER, for NetBSD, with a _heavy_ investment already made in mdoc(7)
formatted documents, I would be quite happy to stick with that.  We
already have groff maintained in-tree, and we'll need it for the
foreseeable future anyway.  It's easy enough to use and it is very well
understood too.

--=20
						Greg A. Woods

H:+1 416 218-0098 W:+1 416 489-5852 x122 VE3TCP RoboHack <woods@robohack.ca>
Planix, Inc. <woods@planix.com>       Secrets of the Weird <woods@weird.com>

--pgp-sign-Multipart_Sun_Apr__1_19:25:31_2007-1
Content-Type: application/pgp-signature
Content-Transfer-Encoding: 7bit

-----BEGIN PGP SIGNATURE-----
Version: PGPfreeware 5.0i for non-commercial use
MessageID: GwZat8wVmfUKGRliBkPlnemYHwkIgpGm

iQA/AwUBRhA/bGZ9cbd4v/R/EQJmFwCgpbR2ucc0PlNMhDr3ktuyRySbUH0Anjlj
HCUeSq4KTZZs5T/Qw24epPEE
=Ba6n
-----END PGP SIGNATURE-----

--pgp-sign-Multipart_Sun_Apr__1_19:25:31_2007-1--