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