Global settings


The commands listed below can be used to modify the default behavior of the XML parser or XSH2 itself. Some of the commands switch between two different modes according to a given expression (which is expected to result either in zero or non-zero value). Other commands also working as a flip-flop have their own explicit counterparts (e.g. verbose and quiet or debug and nodebug). This inconsistency is due to historical reasons.

The encoding and query-encoding settings allow to specify character encodings of user's input and XSH2's own output. This is particularly useful when you work with UTF-8 encoded documents on a console which only supports 8-bit characters.

The settings command displays current settings by means of XSH2 commands. Thus it can not only be used to review current values, but also to store them for future use, e.g. in ~/.xshrc file.

Example 1. 

xsh> settings | cat > ~/.xshrc

Related Topics

backups
turn on backup file creation
switch-to-new-documents
set on/off changing current document to newly open/created files
parser-completes-attributes
turn on/off parser's ability to fill default attribute values
debug
display many annoying debugging messages
empty-tags
turn on/off serialization of empty tags
encoding
character encoding (codepage) identifier
encoding
choose output charset
indent
turn on/off pretty-printing
keep-blanks
turn on/off ignorable whitespace preservation
load-ext-dtd
turn on/off external DTD fetching
nobackups
turn off backup file creation
nodebug
turn off debugging messages
settings
list current settings using XSH2 syntax
parser-expands-entities
turn on/off parser's tendency to expand entities
parser-expands-xinclude
turn on/off transparent XInclude insertion by parser
pedantic-parser
make the parser more pedantic
query-encoding
declare the charset of XSH2 source files and terminal input
quiet
turn off many XSH2 messages
recovering
turn on/off parser's ability to fix broken XML
register-function
define XPath extension function (EXPERIMENTAL)
register-namespace
register namespace prefix to use XPath expressions
register-xhtml-namespace
register a prefix for the XHTML namespace
register-xsh-namespace
register a prefix for the XSH2 namespace
run-mode
switch into normal execution mode (quit test-mode)
skip-dtd
turn on/off serialization of DTD DOCTYPE declaration
test-mode
do not execute any command, only check the syntax
unregister-function
undefine extension function (EXPERIMENTAL)
unregister-namespace
unregister namespace prefix
validation
turn on/off validation in XML parser
verbose
make XSH2 print many messages
xpath-axis-completion
sets TAB completion for axes in xpath expressions in the interactive mode
xpath-completion
turn on/off TAB completion for xpath expressions in the interactive mode
xpath-extensions
map predefined XSH2 XPath extension functions to no or other namespace