GNU AutoGen - The Automated Program Generator: 5.21 trace option

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

## 5.21 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 that you 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.

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

This document was generated by Bruce Korb on March 7, 2011 using texi2html 1.82.