[ 
https://issues.apache.org/jira/browse/DERBY-4401?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12860932#action_12860932
 ] 

Kim Haase commented on DERBY-4401:
----------------------------------

This is terrific -- thank you, Knut. The new USING clause topic is really clear 
and well-written.

My only suggestion would be purely cosmetic -- that the ON and USING part of 
the INNER JOIN syntax be put on separate lines to match the syntax in the LEFT 
OUTER JOIN and RIGHT OUTER JOIN topics (which you cleaned up nicely, I notice).

Kim

> Document USING clause in joins
> ------------------------------
>
>                 Key: DERBY-4401
>                 URL: https://issues.apache.org/jira/browse/DERBY-4401
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 10.6.0.0
>            Reporter: Knut Anders Hatlen
>            Assignee: Knut Anders Hatlen
>            Priority: Minor
>             Fix For: 10.6.0.0
>
>         Attachments: using.diff, using.zip
>
>
> DERBY-4370 made some of the join operations accept a USING clause. This 
> should be documented in the reference manual.
> The JOIN operations section talks about "join clause", which should be fine 
> since that could mean both ON clause and USING clause.
> The sections INNER JOIN operation, LEFT OUTER JOIN operation and RIGHT OUTER 
> JOIN operation need to be updated with the new syntax. We need to replace
> {
>     ON booleanExpression
> }
> with
> {
>     { ON booleanExpression } |
>     { USING ( Simple-column-Name [ , Simple-column-Name ]* ) }
> }
> Perhaps it would make sense to factor out this part of the syntax into a 
> separate element JoinSpecification, and explain the meaning of USING there.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Reply via email to