db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Kim Haase (JIRA)" <j...@apache.org>
Subject [jira] [Updated] (DERBY-6609) Documentation for SQL features should reflect current standard
Date Wed, 18 Jun 2014 18:44:24 GMT

     [ https://issues.apache.org/jira/browse/DERBY-6609?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]

Kim Haase updated DERBY-6609:
-----------------------------

    Attachment: DERBY-6609-2.zip
                DERBY-6609-2.diff

Attaching DERBY-6609-2.diff and DERBY-6609-2.zip. I removed the list that contained the meanings
of the letters, and updated the topics to reflect my current understanding of what is and
isn't supported -- though I know we're still waiting for info on a number of SQL:2011 features.


I also changed the structure of the two topics -- I found it annoying and confusing to have
to go back and forth between the topics to figure out which sub-features in a given category
were supported and which weren't. So I put the unsupported features under the categories into
the tables in the main topic, with "No" to indicate the lack of support. So the "Unsupported
features" topic now contains just two tables, with the features that are entirely unsupported.
I think this simplifies matters. Please let me know if you think it doesn't work.

> Documentation for SQL features should reflect current standard
> --------------------------------------------------------------
>
>                 Key: DERBY-6609
>                 URL: https://issues.apache.org/jira/browse/DERBY-6609
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation
>    Affects Versions: 10.11.0.0
>            Reporter: Kim Haase
>         Attachments: DERBY-6609-2.diff, DERBY-6609-2.zip, DERBY-6609.diff, DERBY-6609.stat,
DERBY-6609.zip
>
>
> We document Derby as an SQL-92 database. This standard is now very old, and we should
describe how Derby conforms to the most current standard (SQL:2011). Knut Anders Hatlen listed
the relevant features in a comment to DERBY-6605. 
> This will involve at a minimum replacing the "Derby support for SQL-92 features" topic
(http://db.apache.org/derby/docs/10.10/ref/rrefsql9241891.html) with a new one that describes
Derby's support for current features, with notes as needed indicating when the support is
partial. Only features Derby supports, fully or partially, should be listed. We should state
that features not listed are not supported.
> The information would be taken from http://wiki.apache.org/db-derby/SQLvsDerbyFeatures
(which currently goes only through the 2003 standard). Listing the Feature IDs in the documentation
would also be helpful. 
> Other topics should be changed as needed. For example, is the term "SQL92Identifier"
still correct?



--
This message was sent by Atlassian JIRA
(v6.2#6252)

Mime
View raw message