[NEW ISSUE] 4177 Disambiguate notational convention for choice syntax

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


        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.



-- 
Fabian Ritzmann
Sun Microsystems, Inc.
Stella Business Park             Phone +358-9-525 562 96
Lars Sonckin kaari 12            Fax   +358-9-525 562 52
02600 Espoo                      Email Fabian.Ritzmann@Sun.COM
Finland