2002/ws/desc/wsdl20 wsdl20-z.html,1.138,1.139 wsdl20.html,1.326,1.327 wsdl20-z-ie.html,1.112,1.113 xmlspec.xsl,1.19,1.20 wsdl20-primer.html,1.190,1.191 from Arthur Ryman via cvs-syncmail on 2007-05-24 (public-ws-desc-eds@w3.org from May 2007)

From: Arthur Ryman via cvs-syncmail <cvsmail@w3.org>
Date: Thu, 24 May 2007 03:33:38 +0000
To: public-ws-desc-eds@w3.org
Message-Id: <E1Hr454-00059f-WE@lionel-hutz.w3.org>
Update of /sources/public/2002/ws/desc/wsdl20
In directory hutz:/tmp/cvs-serv19634/wsdl20

Modified Files:
	wsdl20-z.html wsdl20.html wsdl20-z-ie.html xmlspec.xsl 
	wsdl20-primer.html 
Log Message:
Updated xmlspec.xsl - restored code to handle Z Notation which was accidentally  overwritten by Philippe when preparing PR

Index: wsdl20-z-ie.html
===================================================================
RCS file: /sources/public/2002/ws/desc/wsdl20/wsdl20-z-ie.html,v
retrieving revision 1.112
retrieving revision 1.113
diff -C 2 -d -r1.112 -r1.113
*** wsdl20-z-ie.html	18 May 2007 21:20:41 -0000	1.112
--- wsdl20-z-ie.html	24 May 2007 03:33:35 -0000	1.113
***************
*** 58,62 ****
  	  span.test-assertion { background-color: #FFC0CB; }
  	  span.test-assertion-tr:hover { background-color: #FFC0CB; }
! 	</style><link type="text/css" rel="stylesheet" href="http://www.w3.org/StyleSheets/TR/W3C-PR.css"></head><body><div class="head"><p><a href="http://www.w3.org/"><img width="72" height="48" alt="W3C" src="http://www.w3.org/Icons/w3c_home"></a></p>
  <h1><a id="title" name="title"></a>Web Services Description Language (WSDL) Version 2.0 Part 1: Core Language</h1>
  <h2><a id="w3c-doctype" name="w3c-doctype"></a>W3C Proposed Recommendation 21 March 2007</h2><dl><dt>This version:</dt><dd>
--- 58,62 ----
  	  span.test-assertion { background-color: #FFC0CB; }
  	  span.test-assertion-tr:hover { background-color: #FFC0CB; }
! 	</style><script src="twisty.js" language="JavaScript"></script><link href="zml.css" rel="stylesheet" type="text/css"><link type="text/css" rel="stylesheet" href="http://www.w3.org/StyleSheets/TR/W3C-PR.css"></head><body><div class="head"><p><a href="http://www.w3.org/"><img width="72" height="48" alt="W3C" src="http://www.w3.org/Icons/w3c_home"></a></p>
  <h1><a id="title" name="title"></a>Web Services Description Language (WSDL) Version 2.0 Part 1: Core Language</h1>
  <h2><a id="w3c-doctype" name="w3c-doctype"></a>W3C Proposed Recommendation 21 March 2007</h2><dl><dt>This version:</dt><dd>
***************
*** 407,435 ****
  they are given in the following list. Note that the choice of any
  namespace prefix is arbitrary and not semantically significant (see
! [<cite><a href="#XMLNS">XML Namespaces</a></cite>]).</p><dl><dt class="label">wsdl</dt><dd><p>
!       	"http://www.w3.org/ns/wsdl"
! 	</p><p>Defined by this specification.</p></dd><dt class="label">wsdli</dt><dd><p>"http://www.w3.org/ns/wsdl-instance"</p><p>
!       	Defined by this specification <a href="#wsdlLocation-aii"><b>7.1 wsdli:wsdlLocation attribute information item</b></a>.
!         </p></dd><dt class="label">wsdlx</dt><dd><p>"http://www.w3.org/ns/wsdl-extensions"</p><p>
!       	Defined by this specification <a href="#wsdlx-references"><b>3.3 Describing Messages that Refer to Services and Endpoints</b></a>.
!         </p></dd><dt class="label">wrpc</dt><dd><p>"http://www.w3.org/ns/wsdl/rpc"</p><p>
!       	Defined by WSDL 2.0: Adjuncts [<cite><a href="#WSDL-PART2">WSDL 2.0 Adjuncts</a></cite>].
!         </p></dd><dt class="label">wsoap</dt><dd><p>
!       	"http://www.w3.org/ns/wsdl/soap"
! 	</p><p>
!       	Defined by WSDL 2.0: Adjuncts [<cite><a href="#WSDL-PART2">WSDL 2.0 Adjuncts</a></cite>].
!         </p></dd><dt class="label">whttp</dt><dd><p>
!       	"http://www.w3.org/ns/wsdl/http"
! 	</p><p>
!       	Defined by WSDL 2.0: Adjuncts [<cite><a href="#WSDL-PART2">WSDL 2.0 Adjuncts</a></cite>].
!         </p></dd><dt class="label">xs</dt><dd><p>"http://www.w3.org/2001/XMLSchema"</p><p>
!       		Defined in the W3C XML Schema
!           specification [<cite><a href="#XMLSchemaP1">XML Schema: Structures</a></cite>], [<cite><a href="#XMLSchemaP2">XML Schema: Datatypes</a></cite>].
!          </p></dd><dt class="label">xsi</dt><dd><p>
!       	"http://www.w3.org/2001/XMLSchema-instance"
! 	</p><p>
!       		Defined in the W3C XML Schema
            specification [<cite><a href="#XMLSchemaP1">XML Schema: Structures</a></cite>], [<cite><a href="#XMLSchemaP2">XML Schema: Datatypes</a></cite>].
!          </p></dd></dl></div><div class="div3">
  <h4><a id="terminology" name="terminology"></a>1.4.5 Terms Used in This Specification</h4><p>This section describes the terms and concepts introduced
    in Part 1 of the WSDL Version 2.0 specification (this document).</p><dl><dt class="label">Actual Value</dt><dd><p>As in [<cite><a href="#XMLSchemaP1">XML Schema: Structures</a></cite>],
--- 407,445 ----
  they are given in the following list. Note that the choice of any
  namespace prefix is arbitrary and not semantically significant (see
! [<cite><a href="#XMLNS">XML Namespaces</a></cite>]).</p><a name="tabprefns"></a><table border="1" summary="Mapping of prefixes used in this document to their
!   associated namespace name" xml:space="default"><caption xml:space="default">Table 1-1. Prefixes and Namespaces used in this specification</caption><tbody xml:space="default"><tr xml:space="default"><th rowspan="1" colspan="1" xml:space="default">Prefix</th><th rowspan="1" colspan="1" xml:space="default">Namespace</th><th rowspan="1" colspan="1" xml:space="default">Notes</th></tr><tr xml:space="default"><td rowspan="1" colspan="1" xml:space="default">wsdl</td><td rowspan="1" colspan="1" xml:space="default">
!                 "http://www.w3.org/ns/wsdl"
!               </td><td rowspan="1" colspan="1" xml:space="default">
! 		Defined by this specification.
! 	      </td></tr><tr xml:space="default"><td rowspan="1" colspan="1" xml:space="default">wsdli</td><td rowspan="1" colspan="1" xml:space="default">
! 		"http://www.w3.org/ns/wsdl-instance"
! 	      </td><td rowspan="1" colspan="1" xml:space="default">
! 		Defined by this specification <a href="#wsdlLocation-aii"><b>7.1 wsdli:wsdlLocation attribute information item</b></a>.
! 	      </td></tr><tr xml:space="default"><td rowspan="1" colspan="1" xml:space="default">wsdlx</td><td rowspan="1" colspan="1" xml:space="default">
! 		"http://www.w3.org/ns/wsdl-extensions"
! 	      </td><td rowspan="1" colspan="1" xml:space="default">
! 		Defined by this specification <a href="#wsdlx-references"><b>3.3 Describing Messages that Refer to Services and Endpoints</b></a>.
! 	      </td></tr><tr xml:space="default"><td rowspan="1" colspan="1" xml:space="default">wrpc</td><td rowspan="1" colspan="1" xml:space="default">
! 		"http://www.w3.org/ns/wsdl/rpc"
! 	      </td><td rowspan="1" colspan="1" xml:space="default">
! 		Defined by WSDL 2.0: Adjuncts [<cite><a href="#WSDL-PART2">WSDL 2.0 Adjuncts</a></cite>].
! 	      </td></tr><tr xml:space="default"><td rowspan="1" colspan="1" xml:space="default">wsoap</td><td rowspan="1" colspan="1" xml:space="default">
! 		"http://www.w3.org/ns/wsdl/soap"
! 	      </td><td rowspan="1" colspan="1" xml:space="default">
! 		Defined by WSDL 2.0: Adjuncts [<cite><a href="#WSDL-PART2">WSDL 2.0 Adjuncts</a></cite>].
! 	      </td></tr><tr xml:space="default"><td rowspan="1" colspan="1" xml:space="default">whttp</td><td rowspan="1" colspan="1" xml:space="default">
! 		"http://www.w3.org/ns/wsdl/http"
! 	      </td><td rowspan="1" colspan="1" xml:space="default">
! 		Defined by WSDL 2.0: Adjuncts [<cite><a href="#WSDL-PART2">WSDL 2.0 Adjuncts</a></cite>].
! 	      </td></tr><tr xml:space="default"><td rowspan="1" colspan="1" xml:space="default">xs</td><td rowspan="1" colspan="1" xml:space="default">
! 		"http://www.w3.org/2001/XMLSchema"
! 	      </td><td rowspan="1" colspan="1" xml:space="default">
! 		Defined in the W3C XML Schema
            specification [<cite><a href="#XMLSchemaP1">XML Schema: Structures</a></cite>], [<cite><a href="#XMLSchemaP2">XML Schema: Datatypes</a></cite>].
! 	      </td></tr><tr xml:space="default"><td rowspan="1" colspan="1" xml:space="default">xsi</td><td rowspan="1" colspan="1" xml:space="default">
! 		"http://www.w3.org/2001/XMLSchema-instance"
! 	      </td><td xml:space="default" rowspan="1" colspan="1">
! 		Defined in the W3C XML Schema specification [<cite><a href="#XMLSchemaP1">XML Schema: Structures</a></cite>], [<cite><a href="#XMLSchemaP2">XML Schema: Datatypes</a></cite>].
! 	      </td></tr></tbody></table><br></div><div class="div3">
  <h4><a id="terminology" name="terminology"></a>1.4.5 Terms Used in This Specification</h4><p>This section describes the terms and concepts introduced
    in Part 1 of the WSDL Version 2.0 specification (this document).</p><dl><dt class="label">Actual Value</dt><dd><p>As in [<cite><a href="#XMLSchemaP1">XML Schema: Structures</a></cite>],

Index: wsdl20-z.html
===================================================================
RCS file: /sources/public/2002/ws/desc/wsdl20/wsdl20-z.html,v
retrieving revision 1.138
retrieving revision 1.139
diff -C 2 -d -r1.138 -r1.139
*** wsdl20-z.html	18 May 2007 21:20:37 -0000	1.138
--- wsdl20-z.html	24 May 2007 03:33:32 -0000	1.139
***************
*** 58,62 ****
  	  span.test-assertion { background-color: #FFC0CB; }
  	  span.test-assertion-tr:hover { background-color: #FFC0CB; }
! 	</style><link type="text/css" rel="stylesheet" href="http://www.w3.org/StyleSheets/TR/W3C-PR.css"></head><body><div class="head"><p><a href="http://www.w3.org/"><img width="72" height="48" alt="W3C" src="http://www.w3.org/Icons/w3c_home"></a></p>
  <h1><a id="title" name="title"></a>Web Services Description Language (WSDL) Version 2.0 Part 1: Core Language</h1>
  <h2><a id="w3c-doctype" name="w3c-doctype"></a>W3C Proposed Recommendation 21 March 2007</h2><dl><dt>This version:</dt><dd>
--- 58,62 ----
  	  span.test-assertion { background-color: #FFC0CB; }
  	  span.test-assertion-tr:hover { background-color: #FFC0CB; }
! 	</style><script src="twisty.js" language="JavaScript"></script><link href="zml.css" rel="stylesheet" type="text/css"><link type="text/css" rel="stylesheet" href="http://www.w3.org/StyleSheets/TR/W3C-PR.css"></head><body><div class="head"><p><a href="http://www.w3.org/"><img width="72" height="48" alt="W3C" src="http://www.w3.org/Icons/w3c_home"></a></p>
  <h1><a id="title" name="title"></a>Web Services Description Language (WSDL) Version 2.0 Part 1: Core Language</h1>
  <h2><a id="w3c-doctype" name="w3c-doctype"></a>W3C Proposed Recommendation 21 March 2007</h2><dl><dt>This version:</dt><dd>
***************
*** 407,435 ****
  they are given in the following list. Note that the choice of any
  namespace prefix is arbitrary and not semantically significant (see
! [<cite><a href="#XMLNS">XML Namespaces</a></cite>]).</p><dl><dt class="label">wsdl</dt><dd><p>
!       	"http://www.w3.org/ns/wsdl"
! 	</p><p>Defined by this specification.</p></dd><dt class="label">wsdli</dt><dd><p>"http://www.w3.org/ns/wsdl-instance"</p><p>
!       	Defined by this specification <a href="#wsdlLocation-aii"><b>7.1 wsdli:wsdlLocation attribute information item</b></a>.
!         </p></dd><dt class="label">wsdlx</dt><dd><p>"http://www.w3.org/ns/wsdl-extensions"</p><p>
!       	Defined by this specification <a href="#wsdlx-references"><b>3.3 Describing Messages that Refer to Services and Endpoints</b></a>.
!         </p></dd><dt class="label">wrpc</dt><dd><p>"http://www.w3.org/ns/wsdl/rpc"</p><p>
!       	Defined by WSDL 2.0: Adjuncts [<cite><a href="#WSDL-PART2">WSDL 2.0 Adjuncts</a></cite>].
!         </p></dd><dt class="label">wsoap</dt><dd><p>
!       	"http://www.w3.org/ns/wsdl/soap"
! 	</p><p>
!       	Defined by WSDL 2.0: Adjuncts [<cite><a href="#WSDL-PART2">WSDL 2.0 Adjuncts</a></cite>].
!         </p></dd><dt class="label">whttp</dt><dd><p>
!       	"http://www.w3.org/ns/wsdl/http"
! 	</p><p>
!       	Defined by WSDL 2.0: Adjuncts [<cite><a href="#WSDL-PART2">WSDL 2.0 Adjuncts</a></cite>].
!         </p></dd><dt class="label">xs</dt><dd><p>"http://www.w3.org/2001/XMLSchema"</p><p>
!       		Defined in the W3C XML Schema
!           specification [<cite><a href="#XMLSchemaP1">XML Schema: Structures</a></cite>], [<cite><a href="#XMLSchemaP2">XML Schema: Datatypes</a></cite>].
!          </p></dd><dt class="label">xsi</dt><dd><p>
!       	"http://www.w3.org/2001/XMLSchema-instance"
! 	</p><p>
!       		Defined in the W3C XML Schema
            specification [<cite><a href="#XMLSchemaP1">XML Schema: Structures</a></cite>], [<cite><a href="#XMLSchemaP2">XML Schema: Datatypes</a></cite>].
!          </p></dd></dl></div><div class="div3">
  <h4><a id="terminology" name="terminology"></a>1.4.5 Terms Used in This Specification</h4><p>This section describes the terms and concepts introduced
    in Part 1 of the WSDL Version 2.0 specification (this document).</p><dl><dt class="label">Actual Value</dt><dd><p>As in [<cite><a href="#XMLSchemaP1">XML Schema: Structures</a></cite>],
--- 407,445 ----
  they are given in the following list. Note that the choice of any
  namespace prefix is arbitrary and not semantically significant (see
! [<cite><a href="#XMLNS">XML Namespaces</a></cite>]).</p><a name="tabprefns"></a><table border="1" summary="Mapping of prefixes used in this document to their
!   associated namespace name" xml:space="default"><caption xml:space="default">Table 1-1. Prefixes and Namespaces used in this specification</caption><tbody xml:space="default"><tr xml:space="default"><th rowspan="1" colspan="1" xml:space="default">Prefix</th><th rowspan="1" colspan="1" xml:space="default">Namespace</th><th rowspan="1" colspan="1" xml:space="default">Notes</th></tr><tr xml:space="default"><td rowspan="1" colspan="1" xml:space="default">wsdl</td><td rowspan="1" colspan="1" xml:space="default">
!                 "http://www.w3.org/ns/wsdl"
!               </td><td rowspan="1" colspan="1" xml:space="default">
! 		Defined by this specification.
! 	      </td></tr><tr xml:space="default"><td rowspan="1" colspan="1" xml:space="default">wsdli</td><td rowspan="1" colspan="1" xml:space="default">
! 		"http://www.w3.org/ns/wsdl-instance"
! 	      </td><td rowspan="1" colspan="1" xml:space="default">
! 		Defined by this specification <a href="#wsdlLocation-aii"><b>7.1 wsdli:wsdlLocation attribute information item</b></a>.
! 	      </td></tr><tr xml:space="default"><td rowspan="1" colspan="1" xml:space="default">wsdlx</td><td rowspan="1" colspan="1" xml:space="default">
! 		"http://www.w3.org/ns/wsdl-extensions"
! 	      </td><td rowspan="1" colspan="1" xml:space="default">
! 		Defined by this specification <a href="#wsdlx-references"><b>3.3 Describing Messages that Refer to Services and Endpoints</b></a>.
! 	      </td></tr><tr xml:space="default"><td rowspan="1" colspan="1" xml:space="default">wrpc</td><td rowspan="1" colspan="1" xml:space="default">
! 		"http://www.w3.org/ns/wsdl/rpc"
! 	      </td><td rowspan="1" colspan="1" xml:space="default">
! 		Defined by WSDL 2.0: Adjuncts [<cite><a href="#WSDL-PART2">WSDL 2.0 Adjuncts</a></cite>].
! 	      </td></tr><tr xml:space="default"><td rowspan="1" colspan="1" xml:space="default">wsoap</td><td rowspan="1" colspan="1" xml:space="default">
! 		"http://www.w3.org/ns/wsdl/soap"
! 	      </td><td rowspan="1" colspan="1" xml:space="default">
! 		Defined by WSDL 2.0: Adjuncts [<cite><a href="#WSDL-PART2">WSDL 2.0 Adjuncts</a></cite>].
! 	      </td></tr><tr xml:space="default"><td rowspan="1" colspan="1" xml:space="default">whttp</td><td rowspan="1" colspan="1" xml:space="default">
! 		"http://www.w3.org/ns/wsdl/http"
! 	      </td><td rowspan="1" colspan="1" xml:space="default">
! 		Defined by WSDL 2.0: Adjuncts [<cite><a href="#WSDL-PART2">WSDL 2.0 Adjuncts</a></cite>].
! 	      </td></tr><tr xml:space="default"><td rowspan="1" colspan="1" xml:space="default">xs</td><td rowspan="1" colspan="1" xml:space="default">
! 		"http://www.w3.org/2001/XMLSchema"
! 	      </td><td rowspan="1" colspan="1" xml:space="default">
! 		Defined in the W3C XML Schema
            specification [<cite><a href="#XMLSchemaP1">XML Schema: Structures</a></cite>], [<cite><a href="#XMLSchemaP2">XML Schema: Datatypes</a></cite>].
! 	      </td></tr><tr xml:space="default"><td rowspan="1" colspan="1" xml:space="default">xsi</td><td rowspan="1" colspan="1" xml:space="default">
! 		"http://www.w3.org/2001/XMLSchema-instance"
! 	      </td><td xml:space="default" rowspan="1" colspan="1">
! 		Defined in the W3C XML Schema specification [<cite><a href="#XMLSchemaP1">XML Schema: Structures</a></cite>], [<cite><a href="#XMLSchemaP2">XML Schema: Datatypes</a></cite>].
! 	      </td></tr></tbody></table><br></div><div class="div3">
  <h4><a id="terminology" name="terminology"></a>1.4.5 Terms Used in This Specification</h4><p>This section describes the terms and concepts introduced
    in Part 1 of the WSDL Version 2.0 specification (this document).</p><dl><dt class="label">Actual Value</dt><dd><p>As in [<cite><a href="#XMLSchemaP1">XML Schema: Structures</a></cite>],

Index: xmlspec.xsl
===================================================================
RCS file: /sources/public/2002/ws/desc/wsdl20/xmlspec.xsl,v
retrieving revision 1.19
retrieving revision 1.20
diff -C 2 -d -r1.19 -r1.20
*** xmlspec.xsl	6 Feb 2007 16:38:23 -0000	1.19
--- xmlspec.xsl	24 May 2007 03:33:35 -0000	1.20
***************
*** 38,41 ****
--- 38,51 ----
       ChangeLog: (See also: CVS ChangeLog)
  
+ 	 23 May 2007: Arthur Ryman <ryman@ca.ibm.com>
+ 	   - restored code to handle Z Notation which was accidentally
+ 	     overwritten by Philippe when preparing PR
+ 	 
+ 	 26 December 2004: Arthur Ryman <ryman@ca.ibm.com>
+ 	   - Added JavaScript for handling twisties.
+ 
+ 	 13 October 2004: Arthur Ryman <ryman@ca.ibm.com>
+ 	   - Added link to zml.css for displaying Z notation.
+ 
       15 August 2002: Norman Walsh, <Norman.Walsh@Sun.COM>
         - Version 1.3 released at http://www.w3.org/2002/xmlspec/html/1.3/xmlspec.xsl
***************
*** 2838,2841 ****
--- 2848,2856 ----
        <xsl:value-of select="$additional.css"/>
      </style>
+ 	<!--  AGR added JavaScript and CSS for Z Notation and to hide and show twisty divs -->
+ 	<xsl:if test="$showZed='true'">
+ 	  <script language="JavaScript" src="twisty.js" />
+       <link type="text/css" rel="stylesheet" href="zml.css"/>
+ 	</xsl:if>
      <link rel="stylesheet" type="text/css">
        <xsl:attribute name="href">

Index: wsdl20-primer.html
===================================================================
RCS file: /sources/public/2002/ws/desc/wsdl20/wsdl20-primer.html,v
retrieving revision 1.190
retrieving revision 1.191
diff -C 2 -d -r1.190 -r1.191
*** wsdl20-primer.html	18 May 2007 20:45:54 -0000	1.190
--- wsdl20-primer.html	24 May 2007 03:33:35 -0000	1.191
***************
*** 558,562 ****
    
  &lt;/description&gt;</pre></div></div><div class="div4">
! <h5><a id="example-initial-service-explanation" name="example-initial-service-explanation"></a>2.1.6.1 Explanation of Example</h5><dl><dt class="label"><code>&lt;service name="reservationService"</code></dt><dd><p>This defines a name for this service, which must be unique among service names in the WSDL 2.0 target namespace.   The name attribute is required.  It allows URIs to be created that identify components in WSDL 2.0 description.  (See <em>WSDL 2.0 Core Language</em> [<cite><a href="#WSDL-PART1">WSDL 2.0 Core</a></cite>] appendix C <a href="http://www.w3.org/TR/2007/PR-wsdl20-20070321/#wsdl-uri-references">URI References for WSDL 2.0 constructs</a>.)</p></dd><dt class="label"><code>interface="tns:reservationInterface"&gt;</code></dt><dd><p>This specifies the name of the previously defined interface that these service endpoints will support.  </p></dd><dt class="label"><code>&lt;endpoint name="reservationEndpoint"</code></dt><dd><p>This defines an endpoint for the service, and a name for this endpoit, which must be unique within this service.  </p></dd><dt class="label"><code>binding="tns:reservationSOAPBinding"</code></dt><dd><p>This specifies the name of the previously defined binding to be used by this endpoint.  </p></dd><dt class="label"><code>address ="http://greath.example.com/2004/reservation"/&gt;</code></dt><dd><p>This specifies the physical address at which this service can be accessed using the binding specified by the <code>binding</code> attribute.</p></dd></dl><p>That's it!  Well, almost.  </p></div></div><div class="div3">
  <h4><a id="basics-documentation" name="basics-documentation"></a>2.1.7 Documenting the Service</h4><p>As we have seen, a WSDL 2.0 document is inherently only a <em>partial</em> description of a service.  Although it captures the basic mechanics of interacting with the service -- the message types, transmission protocols, service location, etc. -- in general, additional documentation will need to explain other application-level requirements for its use.  For example, such documentation should explain the purpose and use of the service, the meanings of all messages, constraints on their use, and the sequence in which operations should be invoked.</p><p>The <code>documentation</code> element allows the WSDL 2.0 author to include some human-readable documentation inside a WSDL 2.0 document.   It is also a convenient place to reference any additional external documentation that a client developer may need in order to use the service.   It can appear in a number of places in a WSDL 2.0 document (see <a href="#wdl-infoset-diagram"><b>2.2.1 WSDL 2.0 Infoset</b></a>), though in this example we have only demonstrated its use at the beginning.</p><div class="exampleOuter">
  <p class="exampleHead" style="text-align: left"><a id="example-initial-documentation" name="example-initial-documentation"></a><i><span>Example 2-7. </span>Documenting the GreatH Service</i></p><div class="exampleInner"><pre>&lt;?xml version="1.0" encoding="utf-8" ?&gt; 
--- 558,562 ----
    
  &lt;/description&gt;</pre></div></div><div class="div4">
! <h5><a id="example-initial-service-explanation" name="example-initial-service-explanation"></a>2.1.6.1 Explanation of Example</h5><dl><dt class="label"><code>&lt;service name="reservationService"</code></dt><dd><p>This defines a name for this service, which must be unique among service names in the WSDL 2.0 target namespace.   The name attribute is required.  It allows URIs to be created that identify components in WSDL 2.0 description.  (See <em>WSDL 2.0 Core Language</em> [<cite><a href="#WSDL-PART1">WSDL 2.0 Core</a></cite>] appendix C <a href="http://www.w3.org/TR/2007/PR-wsdl20-20070321/#wsdl-iri-references">IRI References for WSDL 2.0 constructs</a>.)</p></dd><dt class="label"><code>interface="tns:reservationInterface"&gt;</code></dt><dd><p>This specifies the name of the previously defined interface that these service endpoints will support.  </p></dd><dt class="label"><code>&lt;endpoint name="reservationEndpoint"</code></dt><dd><p>This defines an endpoint for the service, and a name for this endpoit, which must be unique within this service.  </p></dd><dt class="label"><code>binding="tns:reservationSOAPBinding"</code></dt><dd><p>This specifies the name of the previously defined binding to be used by this endpoint.  </p></dd><dt class="label"><code>address ="http://greath.example.com/2004/reservation"/&gt;</code></dt><dd><p>This specifies the physical address at which this service can be accessed using the binding specified by the <code>binding</code> attribute.</p></dd></dl><p>That's it!  Well, almost.  </p></div></div><div class="div3">
  <h4><a id="basics-documentation" name="basics-documentation"></a>2.1.7 Documenting the Service</h4><p>As we have seen, a WSDL 2.0 document is inherently only a <em>partial</em> description of a service.  Although it captures the basic mechanics of interacting with the service -- the message types, transmission protocols, service location, etc. -- in general, additional documentation will need to explain other application-level requirements for its use.  For example, such documentation should explain the purpose and use of the service, the meanings of all messages, constraints on their use, and the sequence in which operations should be invoked.</p><p>The <code>documentation</code> element allows the WSDL 2.0 author to include some human-readable documentation inside a WSDL 2.0 document.   It is also a convenient place to reference any additional external documentation that a client developer may need in order to use the service.   It can appear in a number of places in a WSDL 2.0 document (see <a href="#wdl-infoset-diagram"><b>2.2.1 WSDL 2.0 Infoset</b></a>), though in this example we have only demonstrated its use at the beginning.</p><div class="exampleOuter">
  <p class="exampleHead" style="text-align: left"><a id="example-initial-documentation" name="example-initial-documentation"></a><i><span>Example 2-7. </span>Documenting the GreatH Service</i></p><div class="exampleInner"><pre>&lt;?xml version="1.0" encoding="utf-8" ?&gt; 

Index: wsdl20.html
===================================================================
RCS file: /sources/public/2002/ws/desc/wsdl20/wsdl20.html,v
retrieving revision 1.326
retrieving revision 1.327
diff -C 2 -d -r1.326 -r1.327
*** wsdl20.html	18 May 2007 21:20:39 -0000	1.326
--- wsdl20.html	24 May 2007 03:33:33 -0000	1.327
***************
*** 407,435 ****
  they are given in the following list. Note that the choice of any
  namespace prefix is arbitrary and not semantically significant (see
! [<cite><a href="#XMLNS">XML Namespaces</a></cite>]).</p><dl><dt class="label">wsdl</dt><dd><p>
!       	"http://www.w3.org/ns/wsdl"
! 	</p><p>Defined by this specification.</p></dd><dt class="label">wsdli</dt><dd><p>"http://www.w3.org/ns/wsdl-instance"</p><p>
!       	Defined by this specification <a href="#wsdlLocation-aii"><b>7.1 wsdli:wsdlLocation attribute information item</b></a>.
!         </p></dd><dt class="label">wsdlx</dt><dd><p>"http://www.w3.org/ns/wsdl-extensions"</p><p>
!       	Defined by this specification <a href="#wsdlx-references"><b>3.3 Describing Messages that Refer to Services and Endpoints</b></a>.
!         </p></dd><dt class="label">wrpc</dt><dd><p>"http://www.w3.org/ns/wsdl/rpc"</p><p>
!       	Defined by WSDL 2.0: Adjuncts [<cite><a href="#WSDL-PART2">WSDL 2.0 Adjuncts</a></cite>].
!         </p></dd><dt class="label">wsoap</dt><dd><p>
!       	"http://www.w3.org/ns/wsdl/soap"
! 	</p><p>
!       	Defined by WSDL 2.0: Adjuncts [<cite><a href="#WSDL-PART2">WSDL 2.0 Adjuncts</a></cite>].
!         </p></dd><dt class="label">whttp</dt><dd><p>
!       	"http://www.w3.org/ns/wsdl/http"
! 	</p><p>
!       	Defined by WSDL 2.0: Adjuncts [<cite><a href="#WSDL-PART2">WSDL 2.0 Adjuncts</a></cite>].
!         </p></dd><dt class="label">xs</dt><dd><p>"http://www.w3.org/2001/XMLSchema"</p><p>
!       		Defined in the W3C XML Schema
!           specification [<cite><a href="#XMLSchemaP1">XML Schema: Structures</a></cite>], [<cite><a href="#XMLSchemaP2">XML Schema: Datatypes</a></cite>].
!          </p></dd><dt class="label">xsi</dt><dd><p>
!       	"http://www.w3.org/2001/XMLSchema-instance"
! 	</p><p>
!       		Defined in the W3C XML Schema
            specification [<cite><a href="#XMLSchemaP1">XML Schema: Structures</a></cite>], [<cite><a href="#XMLSchemaP2">XML Schema: Datatypes</a></cite>].
!          </p></dd></dl></div><div class="div3">
  <h4><a id="terminology" name="terminology"></a>1.4.5 Terms Used in This Specification</h4><p>This section describes the terms and concepts introduced
    in Part 1 of the WSDL Version 2.0 specification (this document).</p><dl><dt class="label">Actual Value</dt><dd><p>As in [<cite><a href="#XMLSchemaP1">XML Schema: Structures</a></cite>],
--- 407,445 ----
  they are given in the following list. Note that the choice of any
  namespace prefix is arbitrary and not semantically significant (see
! [<cite><a href="#XMLNS">XML Namespaces</a></cite>]).</p><a name="tabprefns"></a><table border="1" summary="Mapping of prefixes used in this document to their
!   associated namespace name" xml:space="default"><caption xml:space="default">Table 1-1. Prefixes and Namespaces used in this specification</caption><tbody xml:space="default"><tr xml:space="default"><th rowspan="1" colspan="1" xml:space="default">Prefix</th><th rowspan="1" colspan="1" xml:space="default">Namespace</th><th rowspan="1" colspan="1" xml:space="default">Notes</th></tr><tr xml:space="default"><td rowspan="1" colspan="1" xml:space="default">wsdl</td><td rowspan="1" colspan="1" xml:space="default">
!                 "http://www.w3.org/ns/wsdl"
!               </td><td rowspan="1" colspan="1" xml:space="default">
! 		Defined by this specification.
! 	      </td></tr><tr xml:space="default"><td rowspan="1" colspan="1" xml:space="default">wsdli</td><td rowspan="1" colspan="1" xml:space="default">
! 		"http://www.w3.org/ns/wsdl-instance"
! 	      </td><td rowspan="1" colspan="1" xml:space="default">
! 		Defined by this specification <a href="#wsdlLocation-aii"><b>7.1 wsdli:wsdlLocation attribute information item</b></a>.
! 	      </td></tr><tr xml:space="default"><td rowspan="1" colspan="1" xml:space="default">wsdlx</td><td rowspan="1" colspan="1" xml:space="default">
! 		"http://www.w3.org/ns/wsdl-extensions"
! 	      </td><td rowspan="1" colspan="1" xml:space="default">
! 		Defined by this specification <a href="#wsdlx-references"><b>3.3 Describing Messages that Refer to Services and Endpoints</b></a>.
! 	      </td></tr><tr xml:space="default"><td rowspan="1" colspan="1" xml:space="default">wrpc</td><td rowspan="1" colspan="1" xml:space="default">
! 		"http://www.w3.org/ns/wsdl/rpc"
! 	      </td><td rowspan="1" colspan="1" xml:space="default">
! 		Defined by WSDL 2.0: Adjuncts [<cite><a href="#WSDL-PART2">WSDL 2.0 Adjuncts</a></cite>].
! 	      </td></tr><tr xml:space="default"><td rowspan="1" colspan="1" xml:space="default">wsoap</td><td rowspan="1" colspan="1" xml:space="default">
! 		"http://www.w3.org/ns/wsdl/soap"
! 	      </td><td rowspan="1" colspan="1" xml:space="default">
! 		Defined by WSDL 2.0: Adjuncts [<cite><a href="#WSDL-PART2">WSDL 2.0 Adjuncts</a></cite>].
! 	      </td></tr><tr xml:space="default"><td rowspan="1" colspan="1" xml:space="default">whttp</td><td rowspan="1" colspan="1" xml:space="default">
! 		"http://www.w3.org/ns/wsdl/http"
! 	      </td><td rowspan="1" colspan="1" xml:space="default">
! 		Defined by WSDL 2.0: Adjuncts [<cite><a href="#WSDL-PART2">WSDL 2.0 Adjuncts</a></cite>].
! 	      </td></tr><tr xml:space="default"><td rowspan="1" colspan="1" xml:space="default">xs</td><td rowspan="1" colspan="1" xml:space="default">
! 		"http://www.w3.org/2001/XMLSchema"
! 	      </td><td rowspan="1" colspan="1" xml:space="default">
! 		Defined in the W3C XML Schema
            specification [<cite><a href="#XMLSchemaP1">XML Schema: Structures</a></cite>], [<cite><a href="#XMLSchemaP2">XML Schema: Datatypes</a></cite>].
! 	      </td></tr><tr xml:space="default"><td rowspan="1" colspan="1" xml:space="default">xsi</td><td rowspan="1" colspan="1" xml:space="default">
! 		"http://www.w3.org/2001/XMLSchema-instance"
! 	      </td><td xml:space="default" rowspan="1" colspan="1">
! 		Defined in the W3C XML Schema specification [<cite><a href="#XMLSchemaP1">XML Schema: Structures</a></cite>], [<cite><a href="#XMLSchemaP2">XML Schema: Datatypes</a></cite>].
! 	      </td></tr></tbody></table><br></div><div class="div3">
  <h4><a id="terminology" name="terminology"></a>1.4.5 Terms Used in This Specification</h4><p>This section describes the terms and concepts introduced
    in Part 1 of the WSDL Version 2.0 specification (this document).</p><dl><dt class="label">Actual Value</dt><dd><p>As in [<cite><a href="#XMLSchemaP1">XML Schema: Structures</a></cite>],
Received on Thursday, 24 May 2007 03:33:48 UTC