[Bug 4177] Disambiguate notational convention for choice syntax

http://www.w3.org/Bugs/Public/show_bug.cgi?id=4177

           Summary: Disambiguate notational convention for choice syntax
           Product: WS-Policy
           Version: LC
          Platform: Macintosh
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Framework+Attachment
        AssignedTo: fsasaki@w3.org
        ReportedBy: fabian.ritzmann@sun.com
         QAContact: public-ws-policy-qa@w3.org


Title

Disambiguate notational convention for choice syntax

Description

Framework and Attachment, section 2.1 each, state:

The character "|" is used to indicate a choice between alternatives.

The character is used exactly twice. The first occurrence is in the framework,
section 4.2:

/wsp:Policy/(@wsu:Id | @xml:id)

The other occurrence is in attachment, section 3.4:

(05)   ( <wsp:Policy> </wsp:Policy> |
(06)     <wsp:PolicyReference> </wsp:PolicyReference> ) +

In both cases, the choice is exclusive. Note the + character which allows
multiple occurrences of Policy and PolicyReference in the second case.
Inclusive choice can always be solved as in the second case.
Justification

We should define the | syntax as exclusive right from the beginning to ease
reading and understanding.

Target

Framework and Attachment

Proposal

In Framework section 2.1 and Attachment section 2.1 replace this:

The character "|" is used to indicate a choice between alternatives.

with this:

The character "|" is used to indicate an exclusive choice between alternatives.

Received on Wednesday, 10 January 2007 10:04:40 UTC