Bug #1092
openFind/Develop Documentation Tools For XBL and Javascript
0%
Description
Need something that works kinda like javadoc so we can pull all the comments and
method.function signatures from the XBL objects and javascript we write.
Dave vieglais mentioned:
js2doxy.pl - http://jsunit.berlios.de/internal.html - which generates C++ pseudo-code from
javascript , and then doxygen (http://www.stack.nl/~dimitri/doxygen) is used to generate
documentation from the C++ pseudo-code. This may work for .js files, but wouldn't work
(probably) for XBL files.
Other options include:
1) using XSLT to transform the XBL files and pull the required data, although this might
be difficult becaus ethe "javascript" comments are currently inside XML <!-- --> comment
tags, so might be ignored by the XSLT parser - is there any way around this?
2) writing a script to parse the files and pull the documentation by pattern-matching -
shoudl be relatively sraightforward since the XBL files are well-structured (XML)