public inbox for [email protected]  

help / color / mirror / Atom feed

<from_item> doc has self referential definition
2+ messages / 2 participants
[nested] [flat]

* <from_item> doc has self referential definition
@ 2018-01-04 02:58 PG Doc comments form <[email protected]>
  2018-01-04 03:33 ` Re: <from_item> doc has self referential definition Tom Lane <[email protected]>
  0 siblings, 1 reply; 2+ messages in thread

From: PG Doc comments form @ 2018-01-04 02:58 UTC (permalink / raw)
  To: pgsql-docs; +Cc: [email protected]

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/9.5/static/sql-select.html
Description:

https://www.postgresql.org/docs/9.6/static/sql-select.html

The last line for <from_item> breaks the group.  There should be something
like:

<from_item>
   <join_from>
   <simple_from>

(with better naming).

Thanks for Postgresql.

Rob


^ permalink  raw  reply  [nested|flat] 2+ messages in thread

* Re: <from_item> doc has self referential definition
  2018-01-04 02:58 <from_item> doc has self referential definition PG Doc comments form <[email protected]>
@ 2018-01-04 03:33 ` Tom Lane <[email protected]>
  0 siblings, 0 replies; 2+ messages in thread

From: Tom Lane @ 2018-01-04 03:33 UTC (permalink / raw)
  To: [email protected]; +Cc: pgsql-docs

=?utf-8?q?PG_Doc_comments_form?= <[email protected]> writes:
> https://www.postgresql.org/docs/9.6/static/sql-select.html

> The last line for <from_item> breaks the group.  There should be something
> like:

> <from_item>
>    <join_from>
>    <simple_from>

> (with better naming).

Hm, I can't get excited about it.  You're correct that the grammar
as stated is ambiguous, and if we introduced another level of
nonterminal we could make it reflect the left-to-right precedence
of join operators ... but I think 99% of our users would just find
it more confusing that way.  The existing statement in the text that
"In the absence of parentheses, JOINs nest left-to-right" is probably
clearer to most people than a formal grammar for it would be.

(Heck, even our actual bison grammar file relies on precedence to
define this behavior, rather than an extra nonterminal ... and you
can't get much nerdier than a bison grammar.)

			regards, tom lane





^ permalink  raw  reply  [nested|flat] 2+ messages in thread

end of thread, other threads:[~2018-01-04 03:33 UTC | newest]

Thread overview: 2+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2018-01-04 02:58 <from_item> doc has self referential definition PG Doc comments form <[email protected]>
2018-01-04 03:33 ` Tom Lane <[email protected]>

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