[
https://issues.apache.org/jira/browse/DERBY-2013?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12462718
]
Kim Haase commented on DERBY-2013:
----------------------------------
The reorganization is really great, Laura -- I think it makes the manual a lot
easier to use. Adding the new header topics helps a lot.
I notice a few minor ordering issues.
1) The SUM and TAN functions need to be switched for alphabetical order.
2) The system functions and procedures are not in alphabetical order. Is there
some reason why not?
3) The JDBC reference section isn't in alphabetical order either. It might make
sense to reorder it to correspond with the javadoc (which separates interfaces,
classes, and exceptions into subgroups and orders them alphabetically). I'd
also suggest putting java.sql.Driver.getPropertyInfo in a subtopic under
java.sql.Driver.
If you don't want to reopen this issue (these are sort of far afield from the
original issue of statement order), I could make some or all of the fixes as
part of DERBY-1920.
> The order of the statements is not alphabetical within the reference manual
> ---------------------------------------------------------------------------
>
> Key: DERBY-2013
> URL: https://issues.apache.org/jira/browse/DERBY-2013
> Project: Derby
> Issue Type: Improvement
> Components: Documentation
> Reporter: Christian d'Heureuse
> Assigned To: Laura Stewart
> Priority: Minor
> Attachments: derby2013_1.diff, derby2013_2.diff, derby2013_3.diff,
> derby2013_4.diff, refguide.zip
>
>
> In the "Statements" chapter of the reference manual, the list of the
> statements starts alphabetically from A to S:
> ALTER TABLE
> CREATE
> DROP
> GRANT
> RENAME
> REVOKE
> SET
> But then then it continues with the letter C:
> CALL
> CONSTRAINT
> DECLARE
> DELETE
> ...
> WHERE
> And within "functions" chapter, it would be better to make a separate section
> for the CASE expression and list it under C (instead of documenting it
> together with the NULLIF expression).
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
https://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira