pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedDocBook upgrade
7+ messages / 5 participants
[nested] [flat]
* DocBook upgrade
@ 2002-01-18 21:53 Peter Eisentraut <peter_e@gmx.net>
2002-01-19 03:51 ` Re: DocBook upgrade Thomas Lockhart <lockhart@fourpalms.org>
2002-01-19 21:30 ` Re: DocBook upgrade Marc G. Fournier <scrappy@hub.org>
2002-03-21 18:06 ` Re: DocBook upgrade Peter Eisentraut <peter_e@gmx.net>
0 siblings, 3 replies; 7+ messages in thread
From: Peter Eisentraut @ 2002-01-18 21:53 UTC (permalink / raw)
To: 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
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: DocBook upgrade
2002-01-18 21:53 DocBook upgrade Peter Eisentraut <peter_e@gmx.net>
@ 2002-01-19 03:51 ` Thomas Lockhart <lockhart@fourpalms.org>
2002-01-20 03:34 ` Re: DocBook upgrade Roberto Mello <rmello@cc.usu.edu>
2002-01-20 21:15 ` Re: DocBook upgrade Peter Eisentraut <peter_e@gmx.net>
2 siblings, 2 replies; 7+ messages in thread
From: Thomas Lockhart @ 2002-01-19 03:51 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: 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:
Great! Do you have an opinion on the rest of the toolchain and
possibilities for XML? afaict SGML/DSSSL is still smoother than XML (and
quite possibly more capable), but I haven't tried the XML tools yet...
- Thomas
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: DocBook upgrade
2002-01-18 21:53 DocBook upgrade Peter Eisentraut <peter_e@gmx.net>
2002-01-19 03:51 ` Re: DocBook upgrade Thomas Lockhart <lockhart@fourpalms.org>
@ 2002-01-20 03:34 ` Roberto Mello <rmello@cc.usu.edu>
1 sibling, 0 replies; 7+ messages in thread
From: Roberto Mello @ 2002-01-20 03:34 UTC (permalink / raw)
To: Thomas Lockhart <lockhart@fourpalms.org>; +Cc: Peter Eisentraut <peter_e@gmx.net>; pgsql-docs
On Sat, Jan 19, 2002 at 03:51:31AM +0000, Thomas Lockhart wrote:
>
> Great! Do you have an opinion on the rest of the toolchain and
> possibilities for XML? afaict SGML/DSSSL is still smoother than XML (and
> quite possibly more capable), but I haven't tried the XML tools yet...
I'd be interested in hearing your experiences with XML. So far I've only
had trouble working with Docbook XML.
-Roberto
--
+----| http://fslc.usu.edu/ USU Free Software & GNU/Linux Club |------+
Roberto Mello - Computer Science, USU - http://www.brasileiro.net/
http://www.sdl.usu.edu/ - Space Dynamics Lab, Developer
Bill Gates made $6.3 Billion selling us MS-DOS?
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: DocBook upgrade
2002-01-18 21:53 DocBook upgrade Peter Eisentraut <peter_e@gmx.net>
2002-01-19 03:51 ` Re: DocBook upgrade Thomas Lockhart <lockhart@fourpalms.org>
@ 2002-01-20 21:15 ` Peter Eisentraut <peter_e@gmx.net>
1 sibling, 0 replies; 7+ messages in thread
From: Peter Eisentraut @ 2002-01-20 21:15 UTC (permalink / raw)
To: Thomas Lockhart <lockhart@fourpalms.org>; +Cc: pgsql-docs
Thomas Lockhart writes:
> Great! Do you have an opinion on the rest of the toolchain and
> possibilities for XML? afaict SGML/DSSSL is still smoother than XML (and
> quite possibly more capable), but I haven't tried the XML tools yet...
The XSL toolchains aren't really any good yet, to be blunt, but as long as
they're still under development we can have a say and part in where the
development goes, but the only way to do that is actually using them.
--
Peter Eisentraut peter_e@gmx.net
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: DocBook upgrade
2002-01-18 21:53 DocBook upgrade Peter Eisentraut <peter_e@gmx.net>
@ 2002-01-19 21:30 ` Marc G. Fournier <scrappy@hub.org>
2 siblings, 0 replies; 7+ messages in thread
From: Marc G. Fournier @ 2002-01-19 21:30 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: pgsql-docs
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
>
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: DocBook upgrade
2002-01-18 21:53 DocBook upgrade Peter Eisentraut <peter_e@gmx.net>
@ 2002-03-21 18:06 ` Peter Eisentraut <peter_e@gmx.net>
2002-03-21 18:39 ` Re: DocBook upgrade Bruce Momjian <pgman@candle.pha.pa.us>
2 siblings, 1 reply; 7+ messages in thread
From: Peter Eisentraut @ 2002-03-21 18:06 UTC (permalink / raw)
To: pgsql-docs
I once wrote:
> Briefly after we open the floodgates for 7.2+1 I would like to upgrade our
> documentation sources to use DocBook 4.1.
Just so you know what the status on this is:
As it turns out, DocBook 4.1 (and 4.0) has some overly restrictive
changes to the content model of some elements (read: "what tags can I put
in what other tags"), and the PostgreSQL documentation is affected by some
of these cases. Part of these changes will be reverted in the DocBook 4.2
release, which went beta the other day and will be released in a month.
Add to that some time to wait for packages to appear and some general
gratuitous hestitation, we might be at least 6 to 8 weeks away from this
move; maybe it won't even be in this cycle.
--
Peter Eisentraut peter_e@gmx.net
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: DocBook upgrade
2002-01-18 21:53 DocBook upgrade Peter Eisentraut <peter_e@gmx.net>
2002-03-21 18:06 ` Re: DocBook upgrade Peter Eisentraut <peter_e@gmx.net>
@ 2002-03-21 18:39 ` Bruce Momjian <pgman@candle.pha.pa.us>
0 siblings, 0 replies; 7+ messages in thread
From: Bruce Momjian @ 2002-03-21 18:39 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: pgsql-docs
Peter Eisentraut wrote:
> I once wrote:
>
> > Briefly after we open the floodgates for 7.2+1 I would like to upgrade our
> > documentation sources to use DocBook 4.1.
>
> Just so you know what the status on this is:
>
> As it turns out, DocBook 4.1 (and 4.0) has some overly restrictive
> changes to the content model of some elements (read: "what tags can I put
> in what other tags"), and the PostgreSQL documentation is affected by some
> of these cases. Part of these changes will be reverted in the DocBook 4.2
> release, which went beta the other day and will be released in a month.
> Add to that some time to wait for packages to appear and some general
> gratuitous hestitation, we might be at least 6 to 8 weeks away from this
> move; maybe it won't even be in this cycle.
^ permalink raw reply [nested|flat] 7+ messages in thread
end of thread, other threads:[~2002-03-21 18:39 UTC | newest]
Thread overview: 7+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2002-01-18 21:53 DocBook upgrade Peter Eisentraut <peter_e@gmx.net>
2002-01-19 03:51 ` Thomas Lockhart <lockhart@fourpalms.org>
2002-01-20 03:34 ` Roberto Mello <rmello@cc.usu.edu>
2002-01-20 21:15 ` Peter Eisentraut <peter_e@gmx.net>
2002-01-19 21:30 ` Marc G. Fournier <scrappy@hub.org>
2002-03-21 18:06 ` Peter Eisentraut <peter_e@gmx.net>
2002-03-21 18:39 ` Bruce Momjian <pgman@candle.pha.pa.us>
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox