W3C home > Mailing lists > Public > www-ws-desc@w3.org > February 2007

Re: XML Syntax Summary in Part 1

From: Arthur Ryman <ryman@ca.ibm.com>
Date: Wed, 7 Feb 2007 14:51:01 -0500
To: "Ramkumar Menon" <ramkumar.menon@gmail.com>
Cc: www-ws-desc@w3.org, www-ws-desc-request@w3.org
Message-ID: <OF5DB77D7C.5B204713-ON8525727B.006B7BA8-8525727B.006C6DD7@ca.ibm.com>

Looks like a bug in the XML syntax summary. Should be *.

The multiple <documentation> elements are for any desired purpose (human 
or machine), and could be used for difference languages.

Arthur Ryman,
IBM Software Group, Rational Division

blog: http://ryman.eclipsedevelopersjournal.com/
phone: +1-905-413-3077, TL 969-3077
assistant: +1-905-413-2411, TL 969-2411
fax: +1-905-413-4920, TL 969-4920
mobile: +1-416-939-5063, text: 4169395063@fido.ca

"Ramkumar Menon" <ramkumar.menon@gmail.com> 
Sent by: www-ws-desc-request@w3.org
02/06/2007 10:24 PM


XML Syntax Summary in Part 1

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 />* 

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

   . . . . . 
<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 ? 

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

-Ramkumar Menon
A typical Macroprocessor 
Received on Wednesday, 7 February 2007 19:51:15 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 21:55:03 UTC