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

• Type: Bug
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 10.10.1.1
• Fix Version/s: 10.10.2.0, 10.11.1.1
• Component/s: Documentation
• Assignee: Camilla Haase
• Reporter: Camilla Haase
• Created: 25/Sep/13 14:47
• Updated: 16/Apr/14 02:41
• Resolved: 02/Oct/13 14:22

Description

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?

Issue Links

• relates to: DERBY-6121 Regularize how we refer to object names in the Reference Manual