# Using &xsldbg;

## xsldbg command arguments

On systems with readline library available you can use the back/forward keys to navigate the history of entered commands. On all systems the last entered command can be repeated by just pressing the <ENTER> key.

If your operating system supports it file names will be expanded.

Several commands take more that one argument. Quotes may be used to lead to complex expressions being treated as one arument. eg break "* | @" would allow you to se a breakpoint on the template with the name "* | @"

## Legend of terms

The following table describes the terms used in the subsiquent command guide

TEMPLATE_NAME : A valid template name contains only ASCI character codes 0x00 to 0x7F. And can be a fully qualified name ie "xsl:templateName".
FILENAME : A valid file name local to the system of the user. It can have a "~" prefix on *nix and CYGWIN platforms. Or environment variables under RISC OS
URI : A Uniform Resource Identifiers as defined by RFC 2396
MODE_NAME The mode of template which can be fully qualified name ie "xsl:modeName".
QNAME : A fully qualified name ie "xsl:localPart"
LINENO : A valid line number in associated <FILENAME>
NUMBER_OF_FRAMES : A valid line number frames to change position by
BREAKPOINT_ID : A valid break point number
WATCH_ID : A valid watch expression number as indicated by showwatch command
SPEED: speed to walk through code at, between 0 to 9
(Comment): a comment about command meaning or usage
{ opt1 | opt2 | opt2 .. etc} : Choose one of the opt's
XPATH : a xpath selection of node(s)
PARAM_ID : a valid parameter number as indicated by showparam command
PATH : A path to change working directory to On some operating systems a "~" prefix will be replaced by your home directory path
TEXT : Free form text (no restrictions)
COMMAND : A valid command for the xsdbg
QNAME : A valid variable/parameter name
SOURCE : The stylesheet being/to be executed. See <FILENAME> and <URI>
DATA : The xml data(document) being/to be processed by the stylesheet. See <FILENAME> and <URI>
DEVICE_PATH : Is a valid terminal on the operating system
TTY_LEVEL : Is a valid level of input/output to use

## Overview of available commands

Help related :help
Running related : {bye|exit| quit}, step, stepup, stepdown, next, continue, run, trace, setoption, options
Libxslt parameter related : addparam, delparam, showparam, output, setoption, options
Template related : templates, where, frame
Break point related : break, showbreak, delete, enable
Expression viewing(xpath) : cat
Node viewing : ls, dir, du, cat, pwd
Variable viewing : globals, locals, cat, addwatch
Variable setting: set
Node selection : source, data, cd
Searching :search
Operating system related :chdir, shell, tty
File related : output, entities, system, public
Disabled file commands: validate, load, save, write, free