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 Tue, 01 Oct 2013 14:54:24 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-2.zip
                DERBY-6353-2.diff

Thanks so much, Knut. 

1) I love nits, and thanks for catching the asterisk one. 

2) Sorry, I got careless and forgot to copy my latest draft into my trunk area with those
last two sentences removed.

I'm attaching DERBY-6353-2.diff and DERBY-6353-2.zip, with the changes I intended. 

> 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-2.diff, DERBY-6353-2.zip, 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