[jira] [Updated] (DERBY-6353) Update syntax description in Getting Started, use in Reference Manual too

["Kim Haase (JIRA)" <ji...@apache.org>]

     [ 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)