Received: from maia.hub.org (maia-3.hub.org [200.46.204.243])
	by mail.postgresql.org (Postfix) with ESMTP id 07D001337BD1;
	Mon,  4 Apr 2011 16:14:47 -0300 (ADT)
Received: from mail.postgresql.org ([200.46.204.86])
	by maia.hub.org (mx1.hub.org [200.46.204.243]) (amavisd-maia,
	port 10024)
	with ESMTP id 60572-01; Mon,  4 Apr 2011 19:14:39 +0000 (UTC)
X-Greylist: from auto-whitelisted by SQLgrey-1.7.6
X-Greylist: from auto-whitelisted by SQLgrey-1.7.6
Received: from mail-iw0-f174.google.com (mail-iw0-f174.google.com
	[209.85.214.174])
	by mail.postgresql.org (Postfix) with ESMTP id C5F941337A67;
	Mon,  4 Apr 2011 16:14:38 -0300 (ADT)
Received: by iwn34 with SMTP id 34so6054612iwn.19
	for <multiple recipients>; Mon, 04 Apr 2011 12:14:38 -0700 (PDT)
MIME-Version: 1.0
Received: by 10.42.136.3 with SMTP id r3mr10902907ict.335.1301944477025; Mon,
	04 Apr 2011 12:14:37 -0700 (PDT)
Received: by 10.42.165.135 with HTTP; Mon, 4 Apr 2011 12:14:36 -0700 (PDT)
In-Reply-To: <BANLkTi=Ux689MQP0UYLwP6b8fL3m1Do6LA@mail.gmail.com>
References: <4D998B49.8050000@2ndQuadrant.it>
	<BANLkTikwxtb9MU-Bn7XqCJSCEdEuJPL+Lg@mail.gmail.com>
	<4D99F09D.3000606@2ndQuadrant.it> <1503.1301935044@sss.pgh.pa.us>
	<4D99FF55.9070301@2ndQuadrant.com>
	<BANLkTinSEBwkFNb7+Ow6+PgR8pKPOj+WGQ@mail.gmail.com>
	<BANLkTi=Ux689MQP0UYLwP6b8fL3m1Do6LA@mail.gmail.com>
Date: Mon, 4 Apr 2011 20:14:36 +0100
Message-ID: <BANLkTin3V564OA1Ame1jn3Bsi7YJNkFOOw@mail.gmail.com>
Subject: Re: [HACKERS] Uppercase SGML entity declarations
From: Dave Page <dpage@pgadmin.org>
To: Robert Haas <robertmhaas@gmail.com>
Cc: Christopher Browne <cbbrowne@gmail.com>,
	Susanne Ebrecht <susanne@2ndquadrant.com>, Tom Lane <tgl@sss.pgh.pa.us>,
	Gabriele Bartolini <gabriele.bartolini@2ndquadrant.it>,
	pgsql-docs@postgresql.org,
	PostgreSQL-development <pgsql-hackers@postgresql.org>
Content-Type: text/plain; charset=ISO-8859-1
X-Virus-Scanned: Maia Mailguard 1.0.1
X-Spam-Status: No, hits=-1.9 tagged_above=-5 required=5 tests=BAYES_00=-1.9
X-Spam-Level: 
X-Archive-Number: 201104/28
X-Sequence-Number: 6599

On 4/4/11, Robert Haas <robertmhaas@gmail.com> wrote:
> 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.
>

I've certainly wasted non-trivial amounts of time trying to get it to
work on some platforms. I'd be *very* glad to see us using a
simplified toolchain if possible.

Another point to note is that whilst it will still be possible to
install older versions of docbook for a while, presumably that'll
become more and more of a pain, as distros update to 5.x, requiring
users to start building manually, and having to deal with parallel
installations of two versions.


-- 
Dave Page
Blog: http://pgsnake.blogspot.com
Twitter: @pgsnake

EnterpriseDB UK: http://www.enterprisedb.com
The Enterprise PostgreSQL Company