pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  

help / color / mirror / Atom feed
From: Tom Lane <tgl@sss.pgh.pa.us>
To: Thom Brown <thom@linux.com>
Cc: pgsql-docs <pgsql-docs@postgresql.org>
Subject: Re: Doc fixes and improvements
Date: Sun, 29 Aug 2010 17:36:53 -0400
Message-ID: <28495.1283117813@sss.pgh.pa.us> (raw)
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>

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



view thread (76+ messages)  latest in thread

Message-ID: <28495.1283117813@sss.pgh.pa.us>
Permalink:  ../28495.1283117813@sss.pgh.pa.us/
Also on:    postgresql.org/message-id/28495.1283117813@sss.pgh.pa.us

 · 

reply
Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-docs@postgresql.org
  Cc: tgl@sss.pgh.pa.us, thom@linux.com
  Subject: Re: Doc fixes and improvements
  In-Reply-To: <28495.1283117813@sss.pgh.pa.us>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox