Re: Window function docs

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

On Fri, Apr 7, 2017 at 01:06:53PM -0400, Tom Lane wrote:
> Bruce Momjian <bruce(at)momjian(dot)us> writes:
> > 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.

I don't think adding another defined term in this dense text is going to
help so I just specified "general-purpose and statistical aggregates"
where needed; patch attached.

I didn't touch any mention of "normal" in reference to
pg_aggregate.aggfnoid where normal/"n" has a specific meaning.

--
Bruce Momjian <bruce(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ As you are, so once was I. As I am, so you will be. +
+ Ancient Roman grave inscription +

Attachment Content-Type Size
window.diff text/x-diff 22.5 KB

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message evanbennett79 2017-04-11 02:10:55 Regular expression case sensitivity documentation inconcistency
Previous Message Heikki Linnakangas 2017-04-07 17:07:41 Documenting "replication" option in startup message