[Laszlo-dev] doctools use of jing and trang

[Benjamin Shine]

(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