(reverse-engineering doctools in preparation for schema summit)
It looks to me like the doctools use jing and trang to validate that
the XML output js2doc produces conforms to ahand-written relax-ng
compact syntax.
hand-written js2doc.rnc schema
gets processed by trang into...
js2doc schema in relax-ng syntax: js2doc.rng
then,
js2doc grovels various files (lzx, not sure what else) and generates
LaszloLibrary.xml and embednew.xml
then,
LaszloLibrary.xml
is repeatedly run through XSLT stylesheets yielding
LaszloLibrary-verbose.js2doc
and finally,
jing validates
LaszloLibrary-verbose.js2doc against js2doc.rng
IN OTHER WORDS:
The doctools use jing and trang to make sure that the doctools are
behaving, but not to actually produce any of the docs or anything
required to generate the docs.
sooooo -- we could semi-safely just stop using jing and trang at all,
anywhere in the doctools process. Non-schema-compliant doctools
output would not be found automatically; it would either be ignored
or it would turn up in a breakage farther down the pipeline.
-ben
