It's difficult to synchronise your software development and documentation. All too often, we tack the documentation onto the software as an afterthought. Many current `integrative' tools are a pain. Here's a solution --- Dogwagger --- where the `tail wags the dog'. Dogwagger extracts the entire source code of the software from the documentation . Documentation must be in the form of a LaTeX (.TEX) file, which also allows you to effortlessly produce publication-quality documentation. It works for Perl, C++, Java, ... whatever!
Without further ado, here's the LaTeX source for Dogwagger itself: Dogwagger20.tex Not only does this file contain the complete source for both the LaTeX and the Perl executable, it's actually a Perl executable in its own right. It, Perl and LaTeX are all you need! Okay, if you merely want to read the documentation, here's the PDF documentation created from the above file: Dogwagger20.pdfAnd by the way here's the Perl executable generated from that same file (by itself)! Dogwagger20.pl (actually, it's saved as Dogwagger20.txt in order not to confuse the server. Rename it after your download).
A caution: This program was written when Perl still contained the ability to use the Tk Graphical User Interface. Recent versions have not maintained this capability, and adding it in is a right royal pain. Sic transit gloria.
| Date of First Publication: 7/7/2005 | Date of Last Update: 2006/10/24 | Web page author: Click here |