Alexander Sayenko wrote: > 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 ? :-)
Alexander, I doubt that there will be any volunteers to add Doxygen support to ns-2 OTcl and the tclcl code; if you or others want to provide documentation fixes, though, I'll incorporate them. ns-3 is using Doxygen, however. Tom