To somehow ease XmHTML development, a number of debug resources are
available. These resources are only effective when XmHTML is compiled with
the -DDEBUG symbol defined, although the resource names
can be used at all times.
Debug Resources
- XmNdisableWarnings
- When set to False, XmHTML will show every warning that occurs. If enabled,
a lot of warnings will be generated mainly be the parser and formatting
routines.
This resource has no effect when _XmHTMLWarning has been called with a
NULL argument for the widget.
- XmNdebugSaveClipmasks
- When set to True, each time a clipmask is created it will be
saved to a file called <image-name>.<number>.xbm.
- XmNdebugFilePrefix
- This resource enables you to take a look at the internal representation
of the parsed HTML file, it need not be the same as the input file.
This is mainly intended for checking the parser's ability to add closing
elements on <p>, <li>, <dd> and <dt>.
An output file is generated for every file/text parsed.
The name of the output file is the prefix appended with the number of
files parsed so far, e.i., the first file will have the extension 0,
the next will have 1 and so on.
- XmNdebugLevels
- This is probably the most powerfull debug resource: it enables debug output
at a source-file level and allows one to examine closely what XmHTML is
doing. This resource is specified as a comma separated list of numbers.
Each number represents a separate source file. See the file DEBUGGING
for the mapping used.
The amount of output generated by using this resource can be enormous,
so you might whish to save it to a file and examine it later.
- XmNdebugNoAnimationLoopCount
- This resource allows one to take a closer look at animations that have
a limited loopcount. A loopcount is the number of times an animation should
be run. Setting this resource to True, XmHTML will ignore any
loopcount setting found in an animation and thus each animation will
run forever.
©Copyright 1996-1997 by Ripley Software Development
Last update: September 19, 1997 by Koen