5.17 trace option

This is the "tracing level of detail" option.

This option has some usage constraints. It:

• This option takes a keyword as its argument. The argument sets an enumeration value that can be tested by comparing the option value macro (OPT_VALUE_TRACE). The available keywords are:

  nothing server-shell templates block-macros expressions everything

This option will cause AutoGen to display a trace of its template processing. There are six levels, each level including messages from the previous levels:

`nothing'

Does no tracing at all (default)

`server-shell'

Traces all input and output to the server shell. This includes a shell "independent" initialization script about 30 lines long. Its output is discarded and not inserted into any template.

`templates'

Traces the invocation of DEFINEd macros and INCLUDEs

`block-macros'

Traces all block macros. The above, plus IF, FOR, CASE and WHILE.

`expressions'

Displays the results of expression evaluations.

`everything'

Displays the invocation of every AutoGen macro, even TEXT macros (i.e. the text outside of macro quotes).

This document was generated by Bruce Korb on September, 30 2006 using texi2html 1.76.