RE: [NEW ISSUE] 4177 Disambiguate notational convention for choice syntax

This minor change looks okay to me. I request the WG to assign this one
to the editors.

 

Regards,

 

Asir S Vedamuthu

Microsoft Corporation

 

From: public-ws-policy-request@w3.org
[mailto:public-ws-policy-request@w3.org] On Behalf Of Fabian Ritzmann
Sent: Wednesday, January 10, 2007 2:08 AM
To: public-ws-policy@w3.org
Subject: [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

Received on Friday, 12 January 2007 09:54:59 UTC