W3C home > Mailing lists > Public > public-ws-policy@w3.org > January 2007

[NEW ISSUE] 4177 Disambiguate notational convention for choice syntax

From: Fabian Ritzmann <Fabian.Ritzmann@Sun.COM>
Date: Wed, 10 Jan 2007 12:07:38 +0200
To: public-ws-policy@w3.org
Message-id: <45A4BAEA.2080704@Sun.COM>
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
Received on Wednesday, 10 January 2007 10:17:29 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 8 January 2008 14:20:45 GMT