Literate Programming with noweb
Norman Ramsey's noweb tools are a simple approach to literate
programming. I personally like noweb because it's usage is simple
(the manual is a single page, yet it contains all the essential
information), yet versatile (it does not depend on the programming
language).
On UNIX systems, the installation should be rather straightforward,
assuming that you have nawk or icon available. For Windows with
cygwin, you can try installing the program using the noweb tarball.
- Extract the source files with tar zxvf noweb-2.11b-cygwin.tgz
- Change into the directory noweb-2.11b/src
- In the Makefile, give in TEXINPUTS the path where you
want to store the latex style file (this needs to be in a
directory that is accessible to your latex distribution).
- If you use emacs, then give in ELISP the path where you want
to store the noweb-mode file.
- Type make all install
If everything goes fine, you should have noweave and
notangle available.
In the above noweb tarball, I changed the bin and lib directories,
replaced nawk by gawk, and added .exe extensions to some
programs. This way, I could get it to work under Windows XP/cygwin.