RE: XML Syntax Summary in Part 1

The schema shows that <description> derives from an ExtensibleDocumented
type, so all the <documentation/> pseudo-syntaxes should be '*'.  I've added
this as an editorial issue CR151.

 

Jonathan Marsh -  <http://www.wso2.com> http://www.wso2.com -
<http://auburnmarshes.spaces.live.com> http://auburnmarshes.spaces.live.com

 

  _____  

From: www-ws-desc-request@w3.org [mailto:www-ws-desc-request@w3.org] On
Behalf Of Ramkumar Menon
Sent: Tuesday, February 06, 2007 7:25 PM
To: www-ws-desc@w3.org
Subject: XML Syntax Summary in Part 1

 

Gurus,

 

Section 9 of Part 1 shows the XML syntax summary for a WSDL document.

 

I am attaching a snippet of the XML.

 

<description targetNamespace="xs:anyURI" >
  <documentation />?

  <import namespace="xs:anyURI" location="xs:anyURI"? >
    <documentation />* 
  </import>*

  <include location="xs:anyURI" >
    <documentation />*
  </include>*

   . . . . . 

<binding name="xs:NCName" interface="xs:QName"? type="xs:anyURI" >
    <documentation />*
      . . . . . 

 

You can note that "description" can possess only zero or one "documentation"
element [as indicated by "?"], whereas other components can have zero or
more documentation elements within them. [as indicated by "*"] 

Is this correct ?

 

Secondly, am I right if I state that multiple documentation tags have been
provisioned only to provide for documentation in different languages using
the "xml:lang" property? Are there any other use-cases for this ? 

 

rgds,

Ram

 



-- 
Shift to the left, shift to the right!
Pop up, push down, byte, byte, byte!

-Ramkumar Menon
A typical Macroprocessor