Confusing example context

Lists: pgsql-docs
From: Thom Brown <thom(at)linux(dot)com>
To: pgsql-docs <pgsql-docs(at)postgresql(dot)org>
Subject: Confusing example context
Date: 2010-08-12 19:49:59
Message-ID: AANLkTin0R2iD0whjPxOUWnA20MR7Y3yAOYJ-dk+0HqQj@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-docs

Hi,

I mentioned this before, but no-one responded to it. This page,
http://www.postgresql.org/docs/9.0/static/sql-syntax-lexical.html, has
some confusing text. It talks about the fact that comments can be
included in SQL, then the next sentence says "For example.." followed
by an example without comments in.

I think the sentence is in the wrong place, so have moved it to a less
confusing location in the attached patch.

Thanks
--
Thom Brown
Registered Linux user: #516935

Attachment Content-Type Size
syntax_paragraph_move.patch text/x-patch 988 bytes

From: Robert Haas <robertmhaas(at)gmail(dot)com>
To: Thom Brown <thom(at)linux(dot)com>
Cc: pgsql-docs <pgsql-docs(at)postgresql(dot)org>
Subject: Re: Confusing example context
Date: 2010-08-13 01:13:07
Message-ID: AANLkTi=pROJZKw_L9fKN64hww_20AkBKW2i-4U7DZFL2@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-docs

On Thu, Aug 12, 2010 at 3:49 PM, Thom Brown <thom(at)linux(dot)com> wrote:
> I mentioned this before, but no-one responded to it.  This page,
> http://www.postgresql.org/docs/9.0/static/sql-syntax-lexical.html, has
> some confusing text.  It talks about the fact that comments can be
> included in SQL, then the next sentence says "For example.." followed
> by an example without comments in.
>
> I think the sentence is in the wrong place, so have moved it to a less
> confusing location in the attached patch.

Committed.

--
Robert Haas
EnterpriseDB: http://www.enterprisedb.com
The Enterprise Postgres Company