Cross linking inside XSchema documentation? (XSchema Spec Section 2.6)

Jarle Stabell jarle.stabell at
Tue Jun 30 20:14:10 BST 1998

Simon St.Laurent wrote:

>2.6.1 Documentation Extensions
>Human-readable documentation for XSchemas should be provided using the Itsy 
>Bitsy Teeny Weeny Simple Hypertext format created by John Cowan.  The full
>is available at  Documentation
>uses portions of the IBTWSH format may be included in the XSC:Doc element, a 
>subelement available to all declarations.  The XSC:Doc element provides
>formatting options for XSchema documentation.

I wonder how one should make (possible) hyperlinks in the doc to other
items inside the XSchema, something "equivalent" to the below:

Doc for ElementX:
"ElementX is for purpose X, it is quite similar to
<ElementName>ElementY</ElementName>, but differs a bit, especially the
attribute <AttributeName>AttributeInX</AttributeName> is very different
from the corresponding <AttributeName
Element="ElementY">AttributeInY</AttributeName> in

Using something like this makes it easy to strip the "hyperlinks" away, or
to convert/process them into real hyperlinks in the end-product documentation.
(An XSchema viewer/editor could of course render them as hyperlinks directly)

Does there already exist a standard way of doing this?

Jarle Stabell

xml-dev: A list for W3C XML Developers. To post, mailto:xml-dev at
Archived as:
To (un)subscribe, mailto:majordomo at the following message;
(un)subscribe xml-dev
To subscribe to the digests, mailto:majordomo at the following message;
subscribe xml-dev-digest
List coordinator, Henry Rzepa (mailto:rzepa at

More information about the Xml-dev mailing list