The <global> element

The global input element of the configuration file contains properties defining global configuration options.

Attribute

Values

Effect

allowExternalFunctions

true|false

True if calls to external Java or .NET functions are allowed

allowMultiThreading

true|false

True if saxon:threads attribute on xsl:for-each causes multi-threading under Saxon-EE; false to disable multi-threading. Default is true (but multi-threading only happens if explicitly requested using saxon:threads.

allowOldJavaUriFormat

true|false

True if reflexive calls to external Java functions are allowed to use the "liberal" syntax (for example "http://my.com/extensions/java.util.Date"). The default is to allow only the "strict" form of URI such as "java:java.util.Date"

collationUriResolver

Name of a class implementing CollationURIResolver

User-supplied class used to intepret collation URIs

collectionUriResolver

Name of a class implementing CollectionURIResolver

User-supplied class used for resolving the URI supplied to the collection() function

compileWithTracing

true|false

generates trace code in the expression tree, allowing a TraceListener to be used at run-time

defaultCollation

A collation URI

(Requires Saxon-PE.) The collation URI to be used when no explicit collation is requested.

defaultCollection

A collection URI

The collection URI to be used when no argument is passed to the collection() function.

dtdValidation

true|false

Controls whether DTD validation is applied to input files.

dtdValidationRecoverable

true|false

Controls whether DTD validation errors are recoverable or fatal.

errorListener

A Java class that implements javax.xml.transform.ErrorListener

Defines the default ErrorListener for reporting both compile-time and run-time errors

expandAttributeDefaults

true|false

Controls whether attribute default values found in a DTD or schema are expanded or not.

lazyConstructionMode

true|false

If true, causes temporary trees to be constructed lazily

lineNumbering

true|false

Controls whether line and column number information is maintained for input files

optimizationLevel

integer, 0 to 10

Defines the level of code optimization to be applied

preEvaluateDocFunction

true|false

If true, allows calls on doc() with a literal argument to be evaluated early, at compile time

preferJaxpParser

true|false

Relevant only on .NET, determines whether the Java Classpath parser is used in preference to the Microsoft .NET parser

recognizeUriQueryParameters

true|false

If true, and the standard URIResolver is in use, query parameters such as val=strict will be recognized on URIs supplied to the doc or document() functions.

schemaValidation

strict|lax|preserve|skip

Controls whether schema validation is applied to input files

serializerFactory

Java class that extends net.sf.saxon.event.SerializerFactory

Allows the serialization pipeline to be customized, for example to handle user-defined serialization parameters

sourceParser

Java class implementing XMLReader

The SAX parser to be used for reading source files.

sourceResolver

Java class name implementing net.sf.saxon.SourceResolver

Name of a user-supplied class that resolves unknown implementations of the JAXP Source class into a known implementation.

stripWhitespace

all|none|ignorable

Controls what whitespace is removed from input documents (all inter-element whitespace, no inter-element whitespace, or all inter-element whitespace in elements having element-only content models)

styleParser

Java Class implementing XMLReader

XML parser used for stylesheets and schema documents

timing

true|false

Outputs progress messages to System.err. Equivalent to the -t option on the command line

traceExternalFunctions

true|false

Provides diagnostics when external functions are dynamically loaded

traceListener

Java Class implementing net.sf.saxon.trace.TraceListener

User-defined class to be used for handling run-time trace output

traceOptimizerDecisions

true|false

Causes tracing of decisions made by the optimizer

treeModel

linkedTree|tinyTree|tinyTreeCondensed

Determines the tree model implementation used for input files: TinyTree, LinkedTree, or TinyTree(condensed)

uriResolver

Name of a JAXP URIResolver

The URIResolver to be used for deferencing URIs used in xsl:include, xsl:import, doc(), and document().

usePiDisableOutputEscaping

true|false

When sending output to a user-defined content handler, indicates whether JAXP-defined processing instructions are used to signal the start and end of text in which output escaping is disabled

useTypedValueCache

true|false

If true, typed values of element and attribute nodes are cached in the TinyTree. Uses extra memory, may make execution faster.

validationComments

true|false

Only relevant when validationWarnings=true, indicates that validation error messages should where possible be added as comments in the document instance being validated rather than fatal errors.

validationWarnings

true|false

For result trees subjected to schema validation, indicates whether validation failures should be treated as warnings rather than fatal errors.

versionOfXml

1.0|1.1

Determines whether XML 1.0 or XML 1.1 rules are used for names. (1.0 means the rules before Edition 5)

xInclude

true|false

Controls whether XInclude processing is applied to input files