Update of "asciidoc literate programming"
Not logged in

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.


Artifact ID: ff9d05627c10126a6494d384458cd81880ff21bd
Page Name:asciidoc literate programming
Date: 2013-07-07 22:32:14
Original User: andrewm
Parent: b7de158dd84bd5c7f883fe188a235fd017acbb76

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 atangle and aweave 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. Atangle is used to extract source code from the document. Aweave adds some annotation and indexing information to the orignal asciidoc source. The use of aweave is optional but adds many index entries and hyperlinks within the document. Both atangle and aweave use noweb style chunk definitions. The 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 downloads page.