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>
Ram,

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

To
www-ws-desc@w3.org
cc

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 
Received on Wednesday, 7 February 2007 19:51:15 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 7 December 2009 10:58:46 GMT