m4: Debugging options
1
1 2.5 Command line options for debugging
1 ======================================
1
1 Finally, there are several options for aiding in debugging 'm4' scripts.
1
1 '-d[FLAGS]'
1 '--debug[=FLAGS]'
1 Set the debug-level according to the flags FLAGS. The debug-level
1 controls the format and amount of information presented by the
1 debugging functions. ⇒Debug Levels, for more details on the
1 format and meaning of FLAGS. If omitted, FLAGS defaults to 'aeq'.
1
1 '--debugfile[=FILE]'
1 '-o FILE'
1 '--error-output=FILE'
1 Redirect 'dumpdef' output, debug messages, and trace output to the
1 named FILE. Warnings, error messages, and 'errprint' output are
1 still printed to standard error. If these options are not used, or
1 if FILE is unspecified (only possible for '--debugfile'), debug
1 output goes to standard error; if FILE is the empty string, debug
1 output is discarded. ⇒Debug Output, for more details. The
1 option '--debugfile' may be given more than once, and order is
1 significant with respect to file names. The spellings '-o' and
1 '--error-output' are misleading and inconsistent with other GNU
1 tools; for now they are silently accepted as synonyms of
1 '--debugfile' and only recognized once, but in a future version of
1 M4, using them will cause a warning to be issued.
1
1 '-l NUM'
1 '--arglength=NUM'
1 Restrict the size of the output generated by macro tracing to NUM
1 characters per trace line. If unspecified or zero, output is
1 unlimited. ⇒Debug Levels, for more details.
1
1 '-t NAME'
1 '--trace=NAME'
1 This enables tracing for the macro NAME, at any point where it is
1 defined. NAME need not be defined when this option is given. This
1 option may be given more than once, and order is significant with
1 respect to file names. ⇒Trace, for more details.
1