2006/ws/policy ws-policy-primer.xml,1.25,1.26

Update of /sources/public/2006/ws/policy
In directory hutz:/tmp/cvs-serv25324

Modified Files:
	ws-policy-primer.xml 
Log Message:
completed editor action item 110 to fix references to xml:id as per bug 4069 fix 

Index: ws-policy-primer.xml
===================================================================
RCS file: /sources/public/2006/ws/policy/ws-policy-primer.xml,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -d -r1.25 -r1.26
--- ws-policy-primer.xml	13 Dec 2006 19:12:30 -0000	1.25
+++ ws-policy-primer.xml	4 Jan 2007 17:25:54 -0000	1.26
@@ -509,8 +509,8 @@
           expressions multiple times. How? It is simple - a policy expression can be named and
           referenced for re-use.</p>
         <p>A policy expression may be identified by an IRI and referenced for re-use as a standalone
-          policy or within another policy expression. There are two mechanisms to identify a policy
-          expression: the <code>wsu:Id</code> and <code>Name</code> attributes. A
+          policy or within another policy expression. There are three mechanisms to identify a policy
+          expression: the <code>wsu:Id</code> <code>xml:id</code> and <code>Name</code> attributes. A
             <code>PolicyReference</code> element can be used to reference a policy expression
           identified using either of these mechanisms.</p>
         <example>
@@ -528,6 +528,19 @@
             <code>http://real.contoso.com/policy.xml#common. (</code>The absolute IRI is formed by
           combining the document IRI, <code>#</code> and the value of the <code>wsu:Id</code>
           attribute.)</p>
+        <p> In addition to the Example 2-12, Contoso could have used either the xml:id or wsu:Id.
+          An example of the use of xml:id similar to that of wsu:Id is shown in Example 2-13. </p>
+       <example>
+       <head>Common Policy Expression [xml:id]</head>
+          <eg xml:space="preserve">&lt;Policy xml:id=”common”&gt;
+  &lt;mtom:OptimizedMimeSerialization wsp:Optional="true"/&gt;
+  &lt;wsap:UsingAddressing /&gt;
+&lt;/Policy&gt;</eg>
+        </example>
+     	<p> Conditions and constraints on the use of the |xml:id| attribute in conjunction with Canonical
+     	 XML 1.0 are specified in Appendix C of <bibref ref="XMLID"/> and are further detailed in <bibref ref="C14NNOTE"/>. 
+     	 Significant care is suggested in the use of xml:id.
+		</p>
         <p>For re-use, a <code>PolicyReference</code> element can be used to reference a policy
           expression as a standalone policy or within another policy expression. The example below
           is a policy expression that re-uses the common policy expression above.</p>
@@ -1089,7 +1102,7 @@
           </item>
         </ulist>
         <p>If the referenced policy expression is in the same XML document as the reference, then
-          the policy expression should be identified using the <code>wsu:Id</code> (XML ID)
+          the policy expression should be identified using the <code>wsu:Id|xml:id</code> (XML ID)
           attribute and referenced using an IRI reference to this XML ID value.</p>
         <p>
           WSDL 1.1 [<bibref ref="WSDL11"/>] section 2.1 and WSDL 2.0 [<bibref ref="WSDL20"/>] chapter 4
@@ -1744,6 +1757,21 @@
           Oblix Inc., OpenNetwork Technologies Inc., Ping Identity Corporation, Reactivity Inc., RSA
           Security Inc., and VeriSign Inc., February 2005. Available at
           http://schemas.xmlsoap.org/ws/2005/02/trust. </bibl>
+        <bibl id="XMLID" key='XML ID' href='http://www.w3.org/TR/2005/REC-xml-id-20050909/'>
+	        <titleref>xml:id Version 1.0</titleref>,
+	        J. Marsh, D. Veillard and N. Walsh, Editors. World Wide Web Consortium,
+	        9 September 2005.  This version of
+	        the xml:id Version 1.0 Recommendation is
+	        http://www.w3.org/TR/2005/REC-xml-id-20050909/. The
+	        <loc href='http://www.w3.org/TR/xml-id/'>latest
+	            version of xml:id Version 1.0</loc> is available at
+	        http://www.w3.org/TR/xml-id/. </bibl>
+        <bibl  id="C14NNOTE" key="C14N 1.0 Note"
+          href="http://www.w3.org/2006/04/c14n-note/c14n-note.html">
+          <titleref>Known Issues with Canonical XML 1.0 (C14N/1.0)</titleref>, 
+          J. Kahan and K. Lanz, Editors. World Wide Web
+          Consortium, 17 August 2006.
+          Available at http://www.w3.org/2006/04/c14n-note/c14n-note.html.>  </bibl>
       </blist>
     </div1> &acknowledgements; <inform-div1 id="change-description">
       <head>Changes in this Version of the Document</head>
@@ -1931,7 +1959,16 @@
               <loc href="http://lists.w3.org/Archives/Public/public-ws-policy/2006Dec/0016.html">as outlined.</loc> 
               Editors' action <loc href="http://www.w3.org/2005/06/tracker/wspolicyeds/actions/94">94</loc>.
             </td>
-          </tr>             
+          </tr>
+          <tr>
+            <td>20070104</td>
+            <td>MH</td>
+            <td>Implemented the resolution for
+              <loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=4069">issue 4069</loc>   
+              <loc href="http://lists.w3.org/Archives/Public/public-ws-policy/2006Dec/0081.html">as outlined.</loc> 
+              Editors' action <loc href="http://www.w3.org/2005/06/tracker/wspolicyeds/actions/110">110</loc>.
+            </td>
+          </tr>                          
         </tbody>
       </table>
     </inform-div1>

Received on Thursday, 4 January 2007 17:26:03 UTC