AutoGen - The Automated Program Generator: 5.17 trace option

[ < ] | [ > ] |  | [ << ] | [ Up ] | [ >> ] |  |  |  |  | [Top] | [Contents] | [Index] | [ ? ]

## 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 `DEFINE`d macros and `INCLUDE`s

``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 October, 7 2007 using texi2html 1.76.