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.

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