Re: Doc fixes and improvements

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Thom Brown <thom(at)linux(dot)com>
Cc: pgsql-docs <pgsql-docs(at)postgresql(dot)org>
Subject: Re: Doc fixes and improvements
Date: 2010-08-29 21:21:31
Message-ID: 28204.1283116891@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-www

Thom Brown <thom(at)linux(dot)com> writes:
> On 29 August 2010 21:31, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:
>> Ummm ... this seems to be almost entirely pointless whitespace changes.
>> Sure you attached the right diff?

> Yes, the whitespace changes you're seeing are because I closed the
> <para> tag early, then re-opened it again for the next paragraph,
> which meant I reduced the indent for the content between them. The
> paragraph is also closed again after, rather than containing
> everything after it, so I removed the excess closing paragraph tag and
> reduce the indentation of the affected sections.

> This is because of what is rendered on:
> http://www.postgresql.org/docs/9.0/static/functions-logical.html

> The sentence "SQL uses a three-valued boolean..." isn't contained in a
> paragraph at all and should be. Otherwise it's free text in a div.

Uh ... it is too enclosed in a <para>. What your changes seem to
accomplish is to take the <simplelist> and <informaltable> constructs
outside any <para>, but what is the point of that? I don't see anything
obviously wrong with the rendering on the page you cite.

regards, tom lane

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Thom Brown 2010-08-29 21:31:25 Re: Doc fixes and improvements
Previous Message Thom Brown 2010-08-29 20:42:31 Re: Doc fixes and improvements

Browse pgsql-www by date

  From Date Subject
Next Message Thom Brown 2010-08-29 21:31:25 Re: Doc fixes and improvements
Previous Message Thom Brown 2010-08-29 20:42:31 Re: Doc fixes and improvements