Minor quibble with description of WINDOW clause

Started by Joshua Tolleyalmost 13 years ago2 messagesdocs
Jump to latest
#1Joshua Tolley
eggyknap@gmail.com

The way the WINDOW clause docs are currently worded, it's clear from the
grammar tree that such clauses come toward the end of the query. But this
phrase made me wonder, incorrectly, whether they were supposed to come before
calls to window functions, somehow:

"...where window_name is a name that can be referenced from subsequent window
definitions or OVER clauses"

See http://www.postgresql.org/docs/9.3/static/sql-select.html#SQL-WINDOW for
the full context.

I'd have preferred to see "...from OVER clauses or subsequent window
definitions", which the attached simple patch does. And if I'm the only one
that likes the idea of such a change, I'll gladly go away quietly. :)

--
Joshua Tolley / eggyknap
End Point Corporation
http://www.endpoint.com

Attachments:

window.doc.patchtext/x-diff; charset=us-asciiDownload+2-2
#2Tom Lane
tgl@sss.pgh.pa.us
In reply to: Joshua Tolley (#1)
Re: Minor quibble with description of WINDOW clause

eggyknap <eggyknap@gmail.com> writes:

The way the WINDOW clause docs are currently worded, it's clear from the
grammar tree that such clauses come toward the end of the query. But this
phrase made me wonder, incorrectly, whether they were supposed to come before
calls to window functions, somehow:

"...where window_name is a name that can be referenced from subsequent window
definitions or OVER clauses"

See http://www.postgresql.org/docs/9.3/static/sql-select.html#SQL-WINDOW for
the full context.

I'd have preferred to see "...from OVER clauses or subsequent window
definitions", which the attached simple patch does. And if I'm the only one
that likes the idea of such a change, I'll gladly go away quietly. :)

I think you're right. Applied and back-patched.

regards, tom lane

--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs