A posting from Fabrice Desré (France Telecom R&D/DMI/GRI) announces the availability of an XSLT stylesheet documentation generator tool. XSLTDoc is itself "an XSLT stylesheet that analyzes another stylesheet, builds clean documentation on it, and also makes some sanity checks. The stylesheet has been developed and tested with xsltproc, part of the 'libxslt' XSLT C library for Gnome. The documentation generated will: (1) show global parameters; (2) show global variables; (3) list all the templates; (4) for each template it shows parameters, variables, templates called via <apply-templates/> from the current one, and templates called via <call-template/> from the current one, checking parameters; (4) builds a cross-reference matrix of called templates; it emits warnings if a named template is never used; (5) in several situations, it tries to show the relevant comments. The supporting web site for XSLTDoc provides an online demo; one may submit a stylesheet and get the result online via a Web browser. A current limitation of the tool is that stylesheets using <xsl:include/> or <xsl:import/> cannot be analyzed." The author plans to support additional semantic checks (à la XSL Lint) and provide DocBook output so it will be easy to make non-HTML documentation.

Sample output from the tool is shown in the stylesheet auto-generated documentation for xsltdoc.xsl.