Subject: Re: DocBook V4.2
From: Rod Taylor <rbt@rbt.ca>
To: Peter Eisentraut <peter_e@gmx.net>
Cc: PostgreSQL Docs <pgsql-docs@postgresql.org>
In-Reply-To: <Pine.LNX.4.44.0306161608450.2751-100000@peter.localdomain>
References: <Pine.LNX.4.44.0306161608450.2751-100000@peter.localdomain>
Content-Type: multipart/signed; micalg=pgp-sha1;
	protocol="application/pgp-signature";
	boundary="=-KrXUweTEAPuUEdWHDd81"
Message-Id: <1055776603.92447.20.camel@jester>
Mime-Version: 1.0
Date: 16 Jun 2003 15:16:44 +0000

--=-KrXUweTEAPuUEdWHDd81
Content-Type: text/plain
Content-Transfer-Encoding: quoted-printable

> We are now beginning to run into trouble with the established toolchain
> (particularly for print output), and there isn't much new development
> happening, so I'd like to start trying out XML-based toolchains.  To do
> that, we need to move to a DocBook version that is available as both SGML
> (processed by OpenJade) and XML, which is the case for 4.x.  We can
> convert SGML to XML automatically, so there are no syntax implications.

I've had good luck processing XML through both toolchains, and would
find it VERY useful if there was the ability to quickly pull in
PostgreSQL content into other in-house documents via an XMLInclude
rather than a hacked checkout, file munge, etc.

I vote for having valid XML in the system itself with each file having a
valid DTD specification.

This has the added benefit of allowing an XSL transform to function on a
single document fairly easily which enables people such as Josh who
don't normally write documentation to quickly validate their changes
with nothing but a webbrowser, a very short set of instructions, and the
URL to the docbook XSLs.

--=20
Rod Taylor <rbt@rbt.ca>

PGP Key: http://www.rbt.ca/rbtpub.asc

--=-KrXUweTEAPuUEdWHDd81
Content-Type: application/pgp-signature; name=signature.asc
Content-Description: This is a digitally signed message part

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.2 (FreeBSD)

iD8DBQA+7d9b6DETLow6vwwRAu2vAJ9x1iZukThGs/TehG16l5IouzjA8wCfRGoN
xHsy9NLVm6hkJ7Djw33zNsk=
=2SBh
-----END PGP SIGNATURE-----

--=-KrXUweTEAPuUEdWHDd81--