Re: [DOCS] Uppercase SGML entity declarations

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