Velocity Reviews - Computer Hardware Reviews

Velocity Reviews > Newsgroups > Programming > XML > tag documentation

Reply
Thread Tools

tag documentation

 
 
Carmen Sei
Guest
Posts: n/a
 
      03-23-2008
for each tag in a namespace, is there easy way to get documentation on
what's that tag use for?

for Java, we have Java Doc, but for XML, do we usually refer to schema
file for the XML?

like XMLSchema name space, it has all the tags like
<xs:sequence>
<xs:element>
<xs:annotation>

where can I get more info for each tag?

===============
<xs:schema xmlnss="http://www.w3.org/2001/XMLSchema"
xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
 
Reply With Quote
 
 
 
 
Martin Honnen
Guest
Posts: n/a
 
      03-23-2008
Carmen Sei wrote:

> like XMLSchema name space, it has all the tags like
> <xs:sequence>
> <xs:element>
> <xs:annotation>
>
> where can I get more info for each tag?
>
> ===============
> <xs:schema xmlnss="http://www.w3.org/2001/XMLSchema"
> xmlns:sql="urn:schemas-microsoft-com:mapping-schema">


It is a W3C recommendation, see <URL:http://www.w3.org/TR/xmlschema-0/>
for an informal introduction and <URL:http://www.w3.org/TR/xmlschema-1/>
and <URL:http://www.w3.org/TR/xmlschema-2/> for the formal specification.

--

Martin Honnen
http://JavaScript.FAQTs.com/
 
Reply With Quote
 
 
 
 
Peter Flynn
Guest
Posts: n/a
 
      03-23-2008
Carmen Sei wrote:
> for each tag in a namespace, is there easy way to get documentation on
> what's that tag use for?


Sometimes.

> for Java, we have Java Doc, but for XML, do we usually refer to schema
> file for the XML?


Unfortunately, that's sometimes all there is.
Or a DTD.
Or the owner's or creator's web site (eg www.docbook.org is an excellent
source of documentation about DocBook). Some industrial Schemas are
proprietary, so you have to be a member (or pay) to get the doc.
Or buy a book...

There have been at least a dozen proposals over the years for methods of
embedding documentation in Schemas and DTDs, mostly in an extractable
format, rather like Knuth's Literate Programming _WEB_, so as to
generate XML documentation, but:

a) none of them have taken off

b) programmers don't write documentation

c) document engineers do, but not usually in the Schema/DTD

d) no-one can agree on how to do it right

The most successful one IMHO is ODD, used to generate grammars and some
documentation for the TEI (www.tei-c.org).

> like XMLSchema name space, it has all the tags like
> <xs:sequence>
> <xs:element>
> <xs:annotation>
>
> where can I get more info for each tag?


This is all documented in the XML Schema Specification at
http://www.w3.org/XML/Schema

> <xs:schema xmlnss="http://www.w3.org/2001/XMLSchema"
> xmlns:sql="urn:schemas-microsoft-com:mapping-schema">


For Microsoft Schemas, ask Microsoft.

///Peter
--
XML FAQ: http://xml.silmaril.ie/
 
Reply With Quote
 
 
 
Reply

Thread Tools

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off
Trackbacks are On
Pingbacks are On
Refbacks are Off


Similar Threads
Thread Thread Starter Forum Replies Last Post
converting XSD documentation to HTML documentation kev.sully@gmail.com XML 1 09-16-2006 12:09 PM
how do u invoke Tag b's Tag Handler from within Tag a's tag Handler? shruds Java 1 01-27-2006 03:00 AM
To vlan tag or not to tag? budyerr Cisco 1 07-08-2004 03:45 AM
Python documentation: How about structured documentation? Looking for comments/suggestions Kenneth McDonald Python 2 05-06-2004 04:11 AM
Principles of documentation (was: Python Documentation Blows!) Cameron Laird Python 1 04-03-2004 06:54 PM



Advertisments
 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57