Setoption

Set an option for execution of stylesheet

You will need to use run command to active changes

Table 3.39. Setoption usage

Example usage : setoption net 1
Example usage : setoption encoding "Some encoding value"
setoption <OPTION_NAME> (<INTEGER_VALUE> | <STRING_VALUE>)
Where <INTEGER_VALUE> is optional for options that can be treated as integer values
Where <OPTION_NAME> can be either

  • debug    (If <INTEGER_VALUE> is true dump the tree of the result instead)

  • catalogs    (If <INTEGER_VALUE> is true use the catalogs from $SGML_CATALOG_FILES or SGML$CatalogFiles for risc operating system)

  • html    (If <INTEGER_VALUE> is true the input document is an HTML file)

  • docbook    (If <INTEGER_VALUE> is true and docbook is still supported by libxml the input document is SGML docbook)

  • xinclude    (If <INTEGER_VALUE> is true do XInclude processing on document input)

  • preferhtml    (If <INTEGER_VALUE> is true prefer html output for search results. See search command)

  • autoencode    (If <INTEGER_VALUE> is true try to use the encoding from the stylesheet)

  • utf8input    (If <INTEGER_VALUE> is true all input from user is in UTF-8. This is normally used when xsldbg is running as a thread)

  • gdb    (Run in gdb compatability mode)

    • For a value of 1 this means

      • Print lots more messages. Increase the frequency of printing "Breakpoint at ..."

      • At most GDB_LINES_TO_PRINT lines will be printed when evaluating expressions, followed by a "...". See options.h to change this value, the default is three lines of text

      • Both local and globals will be printed when the "locals" command is issued

      • When printing expressions with cat/print. The evaluated value will be prefixed by "= " < EXPRESSION >

    • For a value of 2 this means

      • Print messages needed by KDbg as well as the output state above (when value is 1)

  • net    (If <INTEGER_VALUE> is true fetch DTDs or entities over network)

  • valid    (If <INTEGER_VALUE> is true perform the DTD loading phase)

  • repeat    (If <INTEGER_VALUE> is greater than zero(0) then run the transformation <INTEGER_VALUE> times)

  • profile    (If <INTEGER_VALUE> is true dump profiling information)

  • timing    (If <INTEGER_VALUE> is true display the time used)

  • out    (If <INTEGER_VALUE> is true dump the result)

Where value is true if the word "true" is supplied or the value is NOT equal to zero
Where value is false if the word "false" is supplied or value IS equal to zero
Where value is by default true, when no value is supplied, eg setoption net
Where value is by default false if the option name is preceded by "no", e.g. setoption nonet
stdout    Print all error messages to stdout. Normally error messages go to stderr.
setoption <OPTION_NAME> "<STRING_VALUE>"    (Must not contain double quotation marks in <STRING_VALUE>)
setoption <OPTION_NAME> <STRING_VALUE>    (Must not contain any spaces, nor double quotation marks in <STRING_VALUE>)
Where <OPTION_NAME> can be either

  • data    (Data file's URI)

  • source    (Source file's URI)

  • output    (Output file's SystemID )

  • docspath    (Path to use when looking for documentation)

  • catalognames    (The names of the catalogs to use when the catalogs option is set. Value will be lost if set before setting catalogs option)

  • encoding    (What encoding to use for standard output)

  • searchresultspath    What path is to be used when storing the results of searching. If this is not set then xsldbg will use the path of the stylesheet

  • cwd    (The directory changed into by the chdir command)

  • comment    (A freeform comment about the debugger current session)