public inbox for [email protected]  

help / color / mirror / Atom feed

From: David G. Johnston <[email protected]>
To: [email protected] <[email protected]>
To: [email protected] <[email protected]>
Subject: Re: Unclear documentation and requirement of clarification
Date: Fri, 17 Apr 2026 23:29:20 -0700
Message-ID: <CAKFQuwa=LNL8Ub-8ShCvpg4N2u_+MeVRSYRNC8Qj=0Zajp01+g@mail.gmail.com> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>

On Thursday, April 16, 2026, PG Doc comments form <[email protected]>
wrote:

> The following documentation comment has been logged on the website:
>
> Page: https://www.postgresql.org/docs/18/tutorial-agg.html
> Description:
>
> (This restriction exists because the WHERE clause determines which
> rows will be included in the aggregate calculation; so obviously it has to
> be evaluated before aggregate functions are computed.)
>
> This would be better off if it's mentioned that in this particular case, we
> actually need the aggregate function to be computed before the WHERE clause
> and that's why we are using a subquery.
>
>
That is what the parenthetical says, though without introducing the term
subquery.

Without a question or a concrete proposed alternative leaving this as-is
seems reasonable.  I have no qualms with it at least.

David J.

view thread (2+ messages)

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: [email protected]
  Cc: [email protected], [email protected], [email protected]
  Subject: Re: Unclear documentation and requirement of clarification
  In-Reply-To: <CAKFQuwa=LNL8Ub-8ShCvpg4N2u_+MeVRSYRNC8Qj=0Zajp01+g@mail.gmail.com>

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

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