[asciidoc literate programming
[http://www.methods.co.nz/asciidoc | Asciidoc] is a plain text markup tool that can produce a
wide variety of outputs.
It is also very suitable for use in a literate programming environment.
The <b>atangle</b> and <b>aweave</b> programs are literate programming tools for use with asciidoc.
What is different about using asciidoc as a literate programming base, is that the source
is a valid asciidoc document and can be formatted on it own.
<b>Atangle</b> is used to extract source code from the document.
<b>Aweave</b> adds some annotation and indexing information to the orignal
The use of <b>aweave</b> is optional but adds many index entries and hyperlinks
within the document.
Both <b>atangle</b> and <b>aweave</b> use <b>noweb</b> style chunk definitions.
The [/doc/trunk/aweb/doc/atangle.html|documention] describes the format.
The only key point to remember is that source code in asciidoc is contained
between lines of four or more hyphens.
A source code block.
Chunk definitions must be located within source code blocks.
// Defines the "search" chunk.
// References the "found" chunk.
The programs can be obtained from the [Aweb Downloads|downloads] page.