Skip site navigation (1) Skip section navigation (2)

Re: [HACKERS] Uppercase SGML entity declarations

From: Christopher Browne <cbbrowne(at)gmail(dot)com>
To: Susanne Ebrecht <susanne(at)2ndquadrant(dot)com>
Cc: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Gabriele Bartolini <gabriele(dot)bartolini(at)2ndquadrant(dot)it>, Robert Haas <robertmhaas(at)gmail(dot)com>, pgsql-docs(at)postgresql(dot)org, PostgreSQL-development <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: [HACKERS] Uppercase SGML entity declarations
Date: 2011-04-04 18:50:13
Message-ID: BANLkTinSEBwkFNb7+Ow6+PgR8pKPOj+WGQ@mail.gmail.com (view raw or flat)
Thread:
Lists: pgsql-docspgsql-hackers
On Mon, Apr 4, 2011 at 1:26 PM, Susanne Ebrecht <susanne(at)2ndquadrant(dot)com> wrote:
> Anyway, I figured out there is another argument for XML:
>
> My information is that DocBook 5.0 won't support SGML anymore.
>
> Which means - sooner or later a reaction is needed.

Yes, indeed.

I don't think that during the 9.1 alpha phase is the right time to
think about this, but this certainly seems appropriate to consider as
a 9.2 "ToDo" item.

There are arguments as to why to switch to version 5, which is,
indeed, XML-only.
http://www.docbook.org/tdg5/en/html/ch01.html#introduction-why-to-switch

They argue that version 5
- Is what will get fixes.  Which may not matter to us, as I don't
think we have been getting bitten by "horrible DocBook problems."
- Has new functionality.  Which may not matter, as we're doubtless not
using all of the functionality of elder versions of DocBook either.
- Is more extensible.  Which I imagine doesn't matter, as we weren't
extending earlier versions.
- Is easier to customize.  Almost anything would be better than
DSSSL... (http://www.biglist.com/lists/dssslist/archives/200005/msg00120.html
is my little contribution that apparently got used a fair bit by
people)

There is also a possible counter-position to be taken, namely that the
existing tooling works, is mature, and isn't too likely to disappear
in any sort of short term.

In any case, the ToDo shouldn't be about how to convert the SGML to
XML - that's merely one of the tasks.  There is already a ToDo item,
which points here:
<http://archives.postgresql.org/pgsql-docs/2006-12/msg00152.php>

It needs to cover making sure such things as that:
a) The output forms presently used (e.g. - PDF, man pages, perhaps
.chm/.rtf) continue to be available
b) We can clearly document what new toolchain is needed to process the
various output forms, and validate that it's sufficiently free,
sufficiently robust, sufficiently portable, and so forth.
c) Integrating the toolchain into the Postgres build process.

This represents a fair bit of work, so it's a bit of a presumption
that it's a wise move to do this in 9.2.  I don't think the benefits
that the DocBook folk present for moving to v5 are necessarily
compelling to the Postgres community.

BTW, I wear most of the "DocBook hat" for the Slony project, and I
don't see it being valuable to us ("Slony project") to migrate to v5.
It would require quite a bit of work, and I don't see any of the
claimed benefits being helpful to the "Slony us."
-- 
http://linuxfinances.info/info/linuxdistributions.html

In response to

Responses

pgsql-docs by date

Next:From: Robert HaasDate: 2011-04-04 19:02:39
Subject: Re: [HACKERS] Uppercase SGML entity declarations
Previous:From: Robert HaasDate: 2011-04-04 18:48:49
Subject: Re: [HACKERS] Uppercase SGML entity declarations

pgsql-hackers by date

Next:From: Kevin GrittnerDate: 2011-04-04 18:50:37
Subject: Re: time table for beta1
Previous:From: Robert HaasDate: 2011-04-04 18:48:49
Subject: Re: [HACKERS] Uppercase SGML entity declarations

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group