Received: from maia.hub.org (maia-3.hub.org [200.46.204.243])
	by mail.postgresql.org (Postfix) with ESMTP id C0250632B10
	for <pgsql-docs-postgresql.org@mail.postgresql.org>;
	Sun, 29 Aug 2010 18:37:03 -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 12592-02 for
	<pgsql-docs-postgresql.org@mail.postgresql.org>;
	Sun, 29 Aug 2010 21:36:55 +0000 (UTC)
X-Greylist: from auto-whitelisted by SQLgrey-1.7.6
Received: from sss.pgh.pa.us (sss.pgh.pa.us [66.207.139.130])
	by mail.postgresql.org (Postfix) with ESMTP id B71DE632762
	for <pgsql-docs@postgresql.org>; Sun, 29 Aug 2010 18:36:56 -0300 (ADT)
Received: from sss2.sss.pgh.pa.us (tgl@localhost [127.0.0.1])
	by sss.pgh.pa.us (8.14.2/8.14.2) with ESMTP id o7TLas6a028496;
	Sun, 29 Aug 2010 17:36:54 -0400 (EDT)
To: Thom Brown <thom@linux.com>
cc: pgsql-docs <pgsql-docs@postgresql.org>
Subject: Re: Doc fixes and improvements 
In-reply-to: <AANLkTin4gT2q=ZxDQ71EHPVxoCY145W1fTg-VwcTUU=m@mail.gmail.com> 
References: <AANLkTimPYapJDx1N7LjvL5vPmxuQeHNnTT2vLkc2+04i@mail.gmail.com>
	<AANLkTi=DxLhia2teAS=oGdDrXBtNFdP2bjRP4QczWVsF@mail.gmail.com>
	<AANLkTikrmCYo905XbCMsS-kkUDOQK+2ncjUEkYtLM12n@mail.gmail.com>
	<AANLkTik=sM=jPr2+VMGZNsfjuZtTDR2R0ye5mQ8qn-QX@mail.gmail.com>
	<27296.1283113864@sss.pgh.pa.us>
	<AANLkTinDvXCg3KKrif-egktfJMREU3d=uRGsRHQ6YKNL@mail.gmail.com>
	<28204.1283116891@sss.pgh.pa.us>
	<AANLkTin4gT2q=ZxDQ71EHPVxoCY145W1fTg-VwcTUU=m@mail.gmail.com>
Comments: In-reply-to Thom Brown <thom@linux.com>
	message dated "Sun, 29 Aug 2010 22:31:25 +0100"
Date: Sun, 29 Aug 2010 17:36:53 -0400
Message-ID: <28495.1283117813@sss.pgh.pa.us>
From: Tom Lane <tgl@sss.pgh.pa.us>
X-Virus-Scanned: Maia Mailguard 1.0.1
X-Spam-Status: No, hits=-1.91 tagged_above=-5 required=5 tests=BAYES_00=-1.9,
	T_RP_MATCHES_RCVD=-0.01
X-Spam-Level: 
X-Archive-Number: 201008/144
X-Sequence-Number: 5968

Thom Brown <thom@linux.com> writes:
> On 29 August 2010 22:21, Tom Lane <tgl@sss.pgh.pa.us> wrote:
>> What your changes seem to
>> accomplish is to take the <simplelist> and <informaltable> constructs
>> outside any <para>, but what is the point of that?

> Well, those can be in their own <para> container too, although I don't
> think that's an issue.

> But I shalln't pursue it further if you think there's really no issue.

Well, I don't know --- I'm no SGML expert, and I'm not sure whether
there's a preferred style for that.  But I see in a quick grep that
every occurrence of <simplelist> in our docs, and all but a few
occurrences of <informaltable>, are within paras with some surrounding
text, in precisely the same style as here.  So if this needs to be
changed then it needs to be changed in a lot of places.  I'm disinclined
to mess with it unless there's a pretty concrete reason to do so.

			regards, tom lane