3.7 Redirecting Output

AutoGen provides a means for redirecting the template output to different files. It is accomplished by providing a set of Scheme functions named out-* (see section 3.4 AutoGen Scheme Functions).

These functions allow you to logically "push" output files onto a stack and return to previous files by "pop"ing them back off. At the end of processing the template for a particular suffix (see section 3.1 Format of the Pseudo Macro), all the files in the output stack are closed and popped off. Consequently, at the start of the processing of a template, there is only one output file on the stack. That file cannot be popped off.

There are also several functions for determining the output status. See section 3.4 AutoGen Scheme Functions.