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       debug-message server-shell
      templates     block-macros  expressions
      everything

  or their numeric equivalent.

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)

‘`debug-message`’

  Print messages from the "DEBUG" AutoGen macro (see section DEBUG - Print debug message to trace output).

‘`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). Additionally, if you rebuild the “expr.ini” file with debugging enabled, then all calls to AutoGen defined scheme functions will also get logged:

      cd ${top_builddir}/agen5
      DEBUG_ENABLED=true bash bootstrap.dir expr.ini
      make CFLAGS='-g -DDEBUG_ENABLED=1'

  Be aware tha tyou cannot rebuild this source in this way without first having installed the `autogen` executable in your search path. Because of this, "expr.ini" is in the distributed source list, and not in the dependencies.

This document was generated by Bruce Korb on December, 31 2008 using texi2html 1.78.