XOTcl provides 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.