XOTcl provides a help for automatically creating documentation from source code, it is used to document the XOTcl library, but can be used nearly like the javadoc tool java provides.
The class used is documented here: http://media.wu-wien.ac.at/doc/xodoc-xotcl.html
Basically it uses the @ character as a documentation command and generates html from the metadata it finds.