Re: Window function docs

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Bruce Momjian <bruce(at)momjian(dot)us>
Cc: PostgreSQL-documentation <pgsql-docs(at)postgresql(dot)org>
Subject: Re: Window function docs
Date: 2017-04-07 17:06:53
Message-ID: 13483.1491584813@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Bruce Momjian <bruce(at)momjian(dot)us> writes:
> On Thu, Apr 6, 2017 at 06:13:44PM -0400, Tom Lane wrote:
>> Not really convinced by the s/regular/normal/g changes. That doesn't seem
>> to clarify much either. Maybe it would help to define "normal" near here.
>> There's a definition in func.sgml (that they are not ordered-set or
>> hypothetical-set aggregates) but that's too far away.

> This change is not on my patch yes but what do you think about changing
> "regular" and "normal" aggregate designations to "generic"? That seems
> clearer because the aggregates work in non-window and window contexts.

I don't think "generic" is le mot juste here. What's more generic about
avg() than about mode(), for instance?

My dictionary says "generic" means "characteristic of a class or group
of things", which doesn't seem to have anything to do with this.

I actually think "regular" might be a better choice than "normal" for this
purpose, mainly because somebody looking for statistical aggregates might
think that "normal" has something to do with normal distributions. So
maybe we should leave that one group of uses alone and s/normal/regular/
in section 9.20. But in any case it would help to define the term
explicitly in both sections.

regards, tom lane

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Heikki Linnakangas 2017-04-07 17:07:41 Documenting "replication" option in startup message
Previous Message Bruce Momjian 2017-04-07 16:28:54 Re: Window function docs