Directory web/tango-weevil

This is the tango/weevil literate programming tool.  It is a rather
simple system for literate programming (much in the spirit of noweb)
but it has some features I have not seen in other tools:

	It is able to generate intra-file cross references.  This
	way, a code chunk can refer to code chunks in another
	file without linking the files together.

	The tangler is used to generate the cross references.
	This makes it easy, since the tangler knows where the
	output code is going (making determination of variable
	instances easier) and it knows what code chunks it came
	from.

	It is written completely in ANSI-C; no esoteric languages
	like icon are used so porting should be easy.  Note that
	this is ANSI C, if you are using old K&R you are working
	in the dark.

Tango/weevil will support multiple languages and output formats,
although only ANSI C and LaTeX2e are currently supported.  If you
don't have LaTeX2e, get it, it is much nicer to use than plain LaTeX.
Otherwise, you will have to write you own output routine for plain
LaTeX, since many LaTeX2e features are used.

A start of a user's document is included.  It is named userguid.tpc
and has gpic pictures in it.  A file named userguid.tex is also
included, it has the pictures already converted to tpic specials.

This software has been tested for a while and seems stable.  Still,
it might not work for you.  No guarantees.

Corey Minyard
minyard@metronet.com