Received: from maia.hub.org (maia-3.hub.org [200.46.204.243])
	by mail.postgresql.org (Postfix) with ESMTP id E1E041337B47;
	Mon,  4 Apr 2011 16:02:48 -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 22294-06; Mon,  4 Apr 2011 19:02:41 +0000 (UTC)
X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6
X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6
Received: from mail-pw0-f46.google.com (mail-pw0-f46.google.com
	[209.85.160.46])
	by mail.postgresql.org (Postfix) with ESMTP id D59941337A67;
	Mon,  4 Apr 2011 16:02:40 -0300 (ADT)
Received: by pwi15 with SMTP id 15so1520183pwi.19
	for <multiple recipients>; Mon, 04 Apr 2011 12:02:40 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma;
	h=domainkey-signature:mime-version:in-reply-to:references:date
	:message-id:subject:from:to:cc:content-type;
	bh=jXhBkHxmYmk03M5Mpp9RV8Xvux07Ud69pi0MeB1dHPE=;
	b=WaPUhx0ne0sp1x4BYCf8p+VbJNaIM9N9pUotO+hTU4TVp86zNmyNCtMQzBpBrdKP45
	Cmj9vWfMsrRxW1AmRGYDzM04WaW2NYgl7+WC+J4hw10o6RluHUcuRw5C7yDmLlLgpR5w
	hqcv4DqHK5c8eCrWUplW8Wtos2aF4RLZZAzrY=
DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma;
	h=mime-version:in-reply-to:references:date:message-id:subject:from:to
	:cc:content-type;
	b=nMwcK17o9irKPk0OAm0ATm+kUZ+GuXHBimq1J/n9oCxnskg7ODuHJ/RzLiACp1N1rt
	2Ujmxdlfy8yA4UScMM7JsgAaSuJPf4Nul6Qc1CDCsA1AgPx/HeQdmFQuvbFiQ2eCFlVJ
	ScEjt2bQ3HgxmbEx/A70ZUbECwK66k4HAlWLM=
MIME-Version: 1.0
Received: by 10.142.149.38 with SMTP id w38mr6536179wfd.363.1301943760142;
	Mon, 04 Apr 2011 12:02:40 -0700 (PDT)
Received: by 10.68.62.65 with HTTP; Mon, 4 Apr 2011 12:02:39 -0700 (PDT)
In-Reply-To: <BANLkTinSEBwkFNb7+Ow6+PgR8pKPOj+WGQ@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>
Date: Mon, 4 Apr 2011 15:02:39 -0400
Message-ID: <BANLkTi=Ux689MQP0UYLwP6b8fL3m1Do6LA@mail.gmail.com>
Subject: Re: [HACKERS] Uppercase SGML entity declarations
From: Robert Haas <robertmhaas@gmail.com>
To: Christopher Browne <cbbrowne@gmail.com>
Cc: 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.899 tagged_above=-5 required=5 tests=BAYES_00=-1.9,
	FREEMAIL_FROM=0.001
X-Spam-Level: 
X-Archive-Number: 201104/26
X-Sequence-Number: 6597

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