[ 
http://issues.apache.org/jira/browse/DERBY-382?page=comments#action_12314553 ] 

A B commented on DERBY-382:
---------------------------

A couple of minor comments related to UNION/INTERSECT/EXCEPT documentation in 
this manual:

-- p. 59: "Query" -> "Syntax"

Should be an 'or' operator ("|") between "selectExpression" and "VALUES 
expression".

-- p.59: "Duplicates in UNION, INTERSECT, and EXCEPT ALL results"

* Something should be added to the paragraph beginning with "Depending on which 
operation..." to indicate that the number of duplicates shown is only IF the 
"ALL" option is specified.  This is minor, but it'd be a nice clarification to 
have.  Ex:

        Depending on which operation is specified, if the number 
        of copies of a row in the left table is L and the number
        of copies of that row in the right table is R, then the
        number of duplicates of that particular row that the output
        table contains (assuming the "ALL" keyword is specified) is:

* First example ("a Select example") has an extra "FROM" keyword.

* Fifth example ("a values expression") should have a semi-colon at the end of 
it, to be consistent with the other examples.

* Ninth example (p. 60) has an extra quote that needs to be removed:

        WHERE WORKDEPT LIKE 'E%''

should be

        WHERE WORKDEPT LIKE 'E%'


> Doc Review: Derby Reference Manual
> ----------------------------------
>
>          Key: DERBY-382
>          URL: http://issues.apache.org/jira/browse/DERBY-382
>      Project: Derby
>         Type: Improvement
>   Components: Documentation
>  Environment: all
>     Reporter: Jeff Levitt
>     Priority: Minor
>      Fix For: 10.1.1.0

>
> This issue tracks comments for the Derby Reference Manual. The deadline for 
> posting comments is Tuesday, June 28, noon Pacific time.
> Some guidelines to follow when posting comments to this issue are:
> - Try to make clear and concise comments about what you want changed whenever 
> possible.  Provide concrete comments that say "Please change <original> to 
> <modified>" instead of generic comments like "This section needs to be 
> rewritten."
> - If you're reviewing the HTML Files copy, include the URL for the page in 
> the review comment. Obtain the URL like this:
>     * highlight the topic in the left frame
>     * right click
>     * choose "Properties"
>     * copy and paste the address in the pop up box.
> - If you're reviewing the PDF copy, in the review comment:
>     * Include the page number for the PDF, and indicate whether the number is 
> the PDF sheet number or the printed page number.
>     * Include the title of the section that the problem occurs in. If it's in 
> a subsection, try to include the hierarchy of titles.
> - Please don't review the HTML Book copy -- it'll be time consuming to match 
> up that copy with the underlying DITA source.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira

Reply via email to