Re: [DOCS] Uppercase SGML entity declarations - Mailing list pgsql-hackers

From Robert Haas
Subject Re: [DOCS] Uppercase SGML entity declarations
Date
Msg-id BANLkTi=Ux689MQP0UYLwP6b8fL3m1Do6LA@mail.gmail.com
Whole thread Raw
In response to Re: [DOCS] Uppercase SGML entity declarations  (Christopher Browne <cbbrowne@gmail.com>)
Responses Re: [DOCS] Uppercase SGML entity declarations
Re: [DOCS] Uppercase SGML entity declarations
Re: [DOCS] Uppercase SGML entity declarations
Re: [DOCS] Uppercase SGML entity declarations
List pgsql-hackers
On Mon, Apr 4, 2011 at 2:50 PM, Christopher Browne <cbbrowne@gmail.com> wrote:
> On Mon, Apr 4, 2011 at 1:26 PM, Susanne Ebrecht <susanne@2ndquadrant.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

AFAICT, the biggest problem with our existing toolchain is that it's
hard for some people to get it working.  In theory, we have
documentation that explains this:

http://www.postgresql.org/docs/current/static/docguide-toolsets.html

However, in contrast to the vast majority of our documentation, it stinks.

--
Robert Haas
EnterpriseDB: http://www.enterprisedb.com
The Enterprise PostgreSQL Company

pgsql-hackers by date:

Previous
From: Tom Lane
Date:
Subject: Re: GUC assign hooks (was Re: wal_buffers = -1 and SIGHUP)
Next
From: Tom Lane
Date:
Subject: Re: [DOCS] Uppercase SGML entity declarations