[NEW ISSUE] Policy Specification has incorrect examples for the @appliesToattribute of PolicySet

[Mike Edwards <mike_edwards@uk.ibm.com>]

Raiser:        
       Mike Edwards

Target:        
       sca-policy-1.1-spec-cd02-rev6.doc

Description:

The Policy spec has numerous examples
of the @appliesTo attribute of the <policySet/> element.

Most of these examples are formally
incorrect.

The example on line 372 is correct,
with this form:

appliesTo="//sca:binding.ws"

The "//" at the beginning
of the string is essential - the string is an XPath expression and the
expression is evaluated
against all <composite/> document
elements in the Domain.  "//" means "any nodes of the
following type anywhere
in the hierarchy below the root element
(ie below the composite element(s)).

All the other examples of @appliesTo
in the Policy specification omit the leading "//".  This
has the meaning of selecting
all the children of the stated binding
element, where that element is the root element (which of course, it never
is).

Here is an example from line 461, typical
of the other occurrences:

appliesTo="binding.ws"

The following is a list of all the incorrect
examples of @appliesTo in the CD02 Rev6 document:

Line #

461
493
543
557
596
1162
1268
1381
1932


Proposal:

For all examples of the @appliesTo attribute,
ensure that the string begins with "//".

Here is a version of CD02 Rev6 with
the complete set of proposed updates (all changes accepted before creating
this version of the document).





Yours,  Mike.

Strategist - Emerging Technologies, SCA & SDO.
Co Chair OASIS SCA Assembly TC.
IBM Hursley Park, Mail Point 146, Winchester, SO21 2JN, Great Britain.
Phone & FAX: +44-1962-818014    Mobile: +44-7802-467431  
Email:  mike_edwards@uk.ibm.com

---

Unless stated otherwise above:
IBM United Kingdom Limited - Registered in England and Wales with number 741598.
Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU

sca-policy-1.1-spec-cd02-rev6+Issue115.pdf

sca-policy-1.1-spec-cd02-rev6+Issue115.doc