DocBook upgrade - Mailing list pgsql-docs

From Peter Eisentraut
Subject DocBook upgrade
Date
Msg-id Pine.LNX.4.30.0201181629150.708-100000@peter.localdomain
Whole thread Raw
Responses Re: DocBook upgrade
Re: DocBook upgrade
List pgsql-docs
Briefly after we open the floodgates for 7.2+1 I would like to upgrade our
documentation sources to use DocBook 4.1.  There are three reasons for it:

- Some better markup for cases that currently look really ugly.

- The available stylesheets tend to not handle 3.1 correctly in some
  cases.

- We can start exploring XML/XSL-based toolchains.  DocBook XML doesn't
  exist for versions prior to 4.0.

The change will effectively amount to changing the version number at the
very top of the top-level files (book-decl.sgml and postgres.sgml), and
possibly fixing some markup that has been deprecated.

At that time, your processing tools will start complaining that they can't
resolve the public identifier for "-//OASIS//DTD DocBook V4.1//EN" or some
such.  Basically, what you need to do is install the V4.1 DTD in the same
way that 3.1 was installed.  Instructions for this are contained in our
documentation.  I'll be happy to assist if you can't get it to work.

--
Peter Eisentraut   peter_e@gmx.net


pgsql-docs by date:

Previous
From: Elein
Date:
Subject: Re: interactive docs
Next
From: Thomas Lockhart
Date:
Subject: Re: DocBook upgrade