Version 36 of Source Documentation Tools

Updated 2008-12-09 11:29:18 by GraemeP

MAKR, 2004/11/18:

I noticed - and came across the same problem - people on comp.lang.tcl are regularly asking for tools to automatically generate documentation from source code. It seems no page is currently dedicated to maintain a list of tools available for Tcl. So let's start here (in no particular order):

  • ParseTools - extension that can be used to write documentation extractors
  • The Simple Library - framework to support nearly literate programming doc

escargo 21 Apr 2005 - One thing to keep in mind with these tools is that some of them might be used with OO systems that extend the Tcl syntax, Snit for example. Now, instead of just need to track proc definitions, namespaces, and global variables, you might want to keep track of classes, methods, typemethods, and other interesting extended Tcl syntax. I haven't looked at all of these tools, but I know that robodoc made it possible to handle pretty arbitrary things to track and document.

MAKR, 2006-12-08: Half a year ago I decided to move over to robodoc. I now have all in-source documentation (C and Tcl) converted to this format. This was one of the best ideas I ever had. The commentary in the sources is clean and readable. The resulting HTML documentation is it too. You can format it to your liking using CSS...

escargo - Do you use any OO extensions, or just plain Tcl/Tk?

MAKR, 2006-12-13: As it gets tool specific, I continue at the robodoc page ...

MAKR, 2007-12-14, just stumbled over discussions about the Tcl user documentation project and also saw an URL [L3 ] at c.l.t. about how to write manpages.