[ns] OTcl and documentation

[Alexander Sayenko]

Hi

Does anybody know/use a well-proven solution to generate a documentation
from the OTcl code? I tried to find a one, but failed.

* Doxygen does not support OTcl, though it supports Python like comments
which can simplify adding support for the OTcl.

* The OTcl package comes with the otcldoc script, but it generates HTML
output only. I would prefer to have a possibility to control which output I
would like to use.

* There are several scripts that convert the Tcl code into something like C
code so that the Doxygen can parse them but it seems that the OTcl is not
suppported.

Other solutions?

It seems that the NS-2 community would benefit from such a tool since the
main documentation has not been updated for years, while the NS-2 code
changes all the time. It would also eliminate a need to write the same text
twice. Personally, I would like to see the OTcl extension for the Doxygen
program because the NS-2 has both the C++ and OTcl code. Does anybody know
FLEX well enough to extend the Doxygen scanner.l file ? :-)

Sincerely,
Alexander Sayenko (PhD)
Senior Assistant
Telecommunication laboratory, MIT department
University of Jyvaskyla, Finland