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-6353) Update syntax description in Getting Started, use in Reference Manual too
Date Mon, 30 Sep 2013 19:47:23 GMT

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

Kim Haase updated DERBY-6353:
-----------------------------

    Attachment: DERBY-6353.zip
                DERBY-6353.stat
                DERBY-6353.diff

Attaching DERBY-6353.diff, DERBY-6353.stat, and DERBY-6353.zip, with these changes:

M       src/getstart/rgsdocs10012.dita
A       src/ref/crefmprefsyntax.dita
M       src/ref/refderby.ditamap

I removed a couple of sentences from the end of the Reference Manual version of the syntax
topic, because they applied to other manuals but not to this one.

> Update syntax description in Getting Started, use in Reference Manual too
> -------------------------------------------------------------------------
>
>                 Key: DERBY-6353
>                 URL: https://issues.apache.org/jira/browse/DERBY-6353
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation
>    Affects Versions: 10.10.1.1
>            Reporter: Kim Haase
>            Assignee: Kim Haase
>            Priority: Minor
>         Attachments: DERBY-6353.diff, DERBY-6353.stat, DERBY-6353.zip
>
>
> The "SQL Syntax" topic in the Getting Started guide (http://db.apache.org/derby/docs/10.10/getstart/rgsdocs10012.html)
does not describe the curly braces ("{ }") as they are actually used in syntax statements,
where they actually group required items, normally so choices can be separated by vertical
bars ("|"). This should be corrected.
> I also plan to adopt the suggestion made in DERBY-6121 that the topic be added to the
Reference Manual, where syntax is most used. 
> Does anything else in the topic need fixing? I am confused by the statement that the
asterisk "has a special meaning in some SQL statements." What special meaning can it have
other than marking repeatable items?



--
This message was sent by Atlassian JIRA
(v6.1#6144)

Mime
View raw message