Generation of XSD documentation depends on the following tools:
-
xs3p for generating documentation
-
xsdvi for the generation of diagrams, which depends on Apache Xerces
Documentation is entered into the XSD file using the
<xsd:annotation>
and <xsd:documentation>
tags.
e.g.
<schema
xmlns="http://www.w3.org/2001/XMLSchema"
xmlns:cit="http://standards.iso.org/iso/19115/-3/cit/1.0"
targetNamespace="http://standards.iso.org/iso/19110/gfc/1.1" version="1.1">
<!-- =========================== Annotation ============================== -->
<xs:annotation>
<xs:documentation>
### Description
GFC 1.1 is an XML Schema implementation derived from ISO ISO 19110,
Geographic information -- Methodology for feature cataloguing. It includes
...
<xs:documentation>
<xs:annotation>
Command to generate documentation under docs/
:
make docs
Note
|
This command will download all necessary dependencies under .archives/
and place them in corresponding paths.
|
Documentation created from these tools can be seen at: