DEBUG

turns ON/OFF the debug modes of NeXtMidas

<state> ON or OFF
<func>  Specific function or area of debug, ALL for all areas,
        -or- set debug for specified fully qualified class name.

Where <function> can be any of the following:

Function       Description
--------       ------------------------------------------------------------
IO             reports file/pipe opens,grabs,filads, and closes
MACRO          report information on macro execution
PIPES          report information on pipe creation and attaching
GRAPHICS       report information on graphics routines
RESULTS        report information on results handling
PRIMITIVE      report information specific to a primitive
EXECUTIVE      report information on executive primitives (NONE YET - TBD)
ARGS           report information on arguments (nxm.lib.Args.java)
TRACE          report trace back information (stack trace) on exceptions
SUPERTRACE     report source code surrounding exception (if available),
                 requires TRACE to be turned on.
DEPRECATE      report deprecation messages for methods being phased out

If there's a dot in <func>, then assume its a classname and try to set its
static debug state by invoking it's static setDebug(boolean) method.

The current debug state is held in ENV.DEBUG.


Examples:
  1. Display current debug settings
    nM> debug

  2. Turn on all debugging
    nM> debug on all

  3. Turn on ONLY stack traces and show the debug state
    nM> debug off all
    nM> debug on trace
    nM> res env.debug
     7S: ENV.DEBUG       = |Trace|

  4. Turn on debug for the waveform primitive in the current shell
    nM> debug on nxm.sys.prim.waveform


Switches:
  /LOAD=<res> - Restore debug level from the specified result.
                Defaults to "OLDDEBUGMODE" if value is not specified.
  /SAVE=<res> - Store current debug level to the specified result.
                Defaults to "OLDDEBUGMODE" if value is not specified.
  /VERBOSE    - Force display of new debug settings to terminal. (Since 3.1.1)
                [DEF=FALSE in macro, TRUE in interactive shell]

SEE ALSO: ENV