db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Mamta A. Satoor (JIRA)" <derby-...@db.apache.org>
Subject [jira] Commented: (DERBY-382) Doc Review: Derby Reference Manual
Date Tue, 28 Jun 2005 07:48:57 GMT
    [ http://issues.apache.org/jira/browse/DERBY-382?page=comments#action_12314592 ] 

Mamta A. Satoor commented on DERBY-382:

The format of the "DECLARE GLOBAL TEMPORARY TABLE" documentation page got changed from 10.0
documentation to 10.1 documentation. In my opinion, the 10.0 format at http://incubator.apache.org/derby/docs/10.0/manuals/reference/sqlj33.html#HDRDECLARETEMPTABLE
is much clearer than the 10.1 format at http://incubator.apache.org/derby/docs/ref/ref-single.html#rrefdeclaretemptable.

In 10.0, all the options of this sql are explained on one page along with the examples and
restrictions at the bottom of the page. In 10.1, only part of the syntax is explained on the
main page and for the rest of the syntax, there are links at the bottom of the page and this
makes it hard to understand this sql in its entirety. I think John English's recent post on
"Temporary tables not working???   " may have resulted from the fact that ON COMMIT DELETE
ROWS is not listed as default on the main page. 

> 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:

> 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:
For more information on JIRA, see:

View raw message