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

Re: [HACKERS] Uppercase SGML entity declarations

From: Robert Haas <robertmhaas(at)gmail(dot)com>
To: Christopher Browne <cbbrowne(at)gmail(dot)com>
Cc: Susanne Ebrecht <susanne(at)2ndquadrant(dot)com>, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Gabriele Bartolini <gabriele(dot)bartolini(at)2ndquadrant(dot)it>, 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 19:02:39
Message-ID: BANLkTi=Ux689MQP0UYLwP6b8fL3m1Do6LA@mail.gmail.com (view raw or flat)
Thread:
Lists: pgsql-docspgsql-hackers
On Mon, Apr 4, 2011 at 2:50 PM, Christopher Browne <cbbrowne(at)gmail(dot)com> wrote:
> 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

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

In response to

Responses

pgsql-docs by date

Next:From: Tom LaneDate: 2011-04-04 19:08:20
Subject: Re: [HACKERS] Uppercase SGML entity declarations
Previous:From: Christopher BrowneDate: 2011-04-04 18:50:13
Subject: Re: [HACKERS] Uppercase SGML entity declarations

pgsql-hackers by date

Next:From: Tom LaneDate: 2011-04-04 19:08:20
Subject: Re: [HACKERS] Uppercase SGML entity declarations
Previous:From: Tom LaneDate: 2011-04-04 18:58:31
Subject: Re: GUC assign hooks (was Re: wal_buffers = -1 and SIGHUP)

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