PPWIZARD is a free preprocessor for HTML, REXX, Visual Basic or any text files.\ -> Commands -> #option -> DebugLevel
This #option command allows you to modify
the output generated by /debug and
PPWIZARD generates quite a bit of debug information when debug is
on, this is fine for small source files but could easily become hundreds
of thousands of lines in more complex situations.
If you are debugging a specific issue you may want to turn off
debugging of unrelated events (this could also speed things up).
Of course being more selective about placement of
#debug commands is another very
good option (why debug the whole process?).
Note that you can turn off almost all debugging output, doing so could
make it very difficult to determine what is going on as statements such
as #AutoTag could transform lines in what appears to be
a magical manner.
Its up to you to determine what level you require.
You may specify any numbers of commands, each separated by a comma.
A command may begin with a
'-' (to turn off) or
'+' (to turn on) the debug facility or facilities in which
case the current debug level is being addjusted by setting or resetting bits.
If neither "+" nor "-" is used then debug mode is set to exactly the value
By default all nearly all debug output is generated.
Valid debug facilities are:
This represents the default options that PPWIZARD begins
This is almost all the options (excludes user and quoting).
This represents all debug options.
This less "USER?" is the default situation
when PPWIZARD starts.
This represents all debug options being off.
Note that this does not turn off debug, just the optional
All display of lines after some sort of replacement such as
that by #AsIs commands or your macros.
Debug the #AsIs command.
Debug the #AutoTag command.
#if, #endif output etc.
Output related to defining variables/macros.
This debugs PPWIZARD functions that can be used in
#evaluate or #if commands
Output to do with individual processing of your macros.
Output to do with individual processing of your macro's parameters.
Output to do with processing of individual Standard Macros.
Debug any IMPORT statements PPWIZARD performs. This will
also automatically adjust "MACROVALORDEF".
Debug any INTERPRET statements PPWIZARD performs. PPWIZARD
does not trace all but will show ones from #if
and #evaluate commands.
PPWIZARD allows some things to be defined via a macro, there
is usually a default value. This debugs these situations.
Any output related to #option command.
Debug commands executed by operating system.
Debug the calls that grab
Debug the #RexxVar command.
Turn on rexx's inbuilt tracing for the execution of any
rexx code that gets executed by commands such as
#if, #evaluate and
#import. This can be quite extensive so you
might want to turn it off or lower its level (see below) for
general debugging. The format of the output is described below.
The PPWIZARD macro "REXXTRACE" can be used
to control the level of rexx debugging. The default level
is "INTERMEDIATES" with "RESULTS" generating
less output while still being useful. The value you specified
is used in the rexx "TRACE ???" command.
Preceeding the value with '?' (as in "?Results") turns on
interactive trace. You can execute any rexx
commands to display or modify values.
Show all spelling related output?
- USER1 & USER2
Nothing in ppwizard itself makes use of these debug states,
you can make use these for your own purposes.
You can use these two flags either as a number
(ranging from 0 to 3) for as 2 options (on or off).
To test the current state you need to call
The value of USER bit one is 1 and USER bit two is 2.
Note that you could define your own debug "flags" using
"/define depending on the type of debug.
The disadvantage on using these bits is the mimimum extra
debug output is the contents of each line as it is processed.
Lets turn off all optional debugging except
CONDITIONAL and OPTIONS:
Saturday May 28 2022 at 2:55pm