3.1.1. Tangling

This section describes the requirements of the tangling goal, and is by far the simplest to state (and implement).

The client will largely present files containing one or more program code files, separated by documentation sections. The tangler basically extracts this code, concatenates the sections sequentially, and writes the output verbatim to code files. Code sections targeting a single output file must be associated, and the target file identified and its location determined.

The detailed requirements for tangling, therefore, largely focus on deviations from normal processing. Supported Programming Languages Source Tracking Chunking Parsing for reference tables Parsing for embedded documentation Internationalisation