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 |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs pgsql-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
From | Date | Subject | |
---|---|---|---|
Next Message | Tom Lane | 2011-04-04 19:08:20 | Re: [HACKERS] Uppercase SGML entity declarations |
Previous Message | Christopher Browne | 2011-04-04 18:50:13 | Re: [HACKERS] Uppercase SGML entity declarations |
From | Date | Subject | |
---|---|---|---|
Next Message | Tom Lane | 2011-04-04 19:08:20 | Re: [HACKERS] Uppercase SGML entity declarations |
Previous Message | Tom Lane | 2011-04-04 18:58:31 | Re: GUC assign hooks (was Re: wal_buffers = -1 and SIGHUP) |