Re: [DOCS] mistype - Mailing list pgsql-docs

From David G. Johnston
Subject Re: [DOCS] mistype
Date
Msg-id CAKFQuwac9ntqe+c-Ns-+da0YF1TCq03vRa2tt-H1yKRSracvJA@mail.gmail.com
Whole thread Raw
In response to [DOCS] mistype  (splarv@ya.ru)
List pgsql-docs
On Fri, Aug 25, 2017 at 12:19 PM, <splarv@ya.ru> wrote:
The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/9.6/static/sql-expressions.html
Description:

cite &quot;The restriction about appearing only in the result list or HAVING
clause applies with respect to the query level that the aggregate belongs
to.&quot;

May be &quot;the restriction above&quot;?

​Or, "The restriction that variables must appear only in the result list or HAVING clause applies to the query level to which the aggregate expression belongs." (I would consider emphasizing the word belongs).

Really, just adding the word variables - "The restriction about variables appearing only" - would make it technically correct.

Your proposal of only changing "about" to "above" makes it grammatically wrong and fails to fix the underlying problem.  "about" it is right word but the sentence fails to provide "what", what must only appear in the result list or having clause?

A meaningful example might help too - I'm having trouble imaging when one would choose to write a subquery whose effect would end up being treated as part of the main query.

David J.

pgsql-docs by date:

Previous
From: Tom Lane
Date:
Subject: Re: [DOCS] Failing example for to_number()
Next
From: Richard Swagerman
Date:
Subject: [DOCS] search box and page banner when building html