Received: from earth.hub.org (earth.hub.org [64.49.215.11]) by postgresql.org (8.11.3/8.11.4) with ESMTP id g0JLU6V80643 for ; Sat, 19 Jan 2002 16:30:06 -0500 (EST) (envelope-from scrappy@hub.org) Received: from localhost (scrappy@localhost) by earth.hub.org (8.11.3/8.11.6) with ESMTP id g0JLU3K73521; Sat, 19 Jan 2002 17:30:03 -0400 (AST) (envelope-from scrappy@hub.org) Date: Sat, 19 Jan 2002 17:30:01 -0400 (AST) From: "Marc G. Fournier" To: Peter Eisentraut cc: pgsql-docs@postgresql.org Subject: Re: DocBook upgrade In-Reply-To: Message-ID: <20020119172950.I8412-100000@earth.hub.org> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII X-Archive-Number: 200201/23 X-Sequence-Number: 1222 Let me know what you need me to install ... On Fri, 18 Jan 2002, Peter Eisentraut wrote: > 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 > > > ---------------------------(end of broadcast)--------------------------- > TIP 3: if posting/reading through Usenet, please send an appropriate > subscribe-nomail command to majordomo@postgresql.org so that your > message can get through to the mailing list cleanly >