The <global> element
The global
input element of the configuration file contains properties defining global configuration options.
Attribute |
Applies to |
Values |
Effect |
|
EE |
String |
Defines the protocols (for example "file" and "http") that may be used in URIs resolved by Saxon. |
|
HE PE EE |
true|false |
True if reflexive calls to external Java functions are allowed. |
|
EE |
true|false |
True if saxon:threads attribute on |
|
PE EE |
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". |
|
PE EE |
true|false |
Enables use of (experimental and non-conformant) extensions to XPath syntax. |
|
HE PE EE |
Name of a class implementing CollationURIResolver |
User-supplied class used to interpret collation URIs. |
|
HE PE EE |
Name of a class implementing CollectionFinder |
User-supplied class used for retrieving the ResourceCollection to resolve the URI supplied to the collection() function. |
|
HE PE EE |
true|false |
Generates trace code in the expression tree, allowing a TraceListener to be used at run-time. |
|
EE |
true|false |
Obsolete and ignored from Saxon 12.0. |
|
EE |
A directory name |
Obsolete and ignored from Saxon 12.0. |
|
HE PE EE |
Absolute URI (collation URI) |
(Requires Saxon-PE.) The collation URI to be used when no explicit collation is requested. |
|
HE PE EE |
Absolute URI (collection URI) |
The collection URI to be used when no argument is passed to the collection() function. |
|
HE PE EE |
string ("S" for Saxon, "J" for Java, "N" for .NET) |
Determines which regular expression engine should be used for evaluating regular expressions. |
|
EE |
true|false |
Obsolete and ignored from Saxon 12.0. |
|
HE PE EE |
true|false |
Controls whether DTD validation is applied to input files. |
|
HE PE EE |
true|false |
Controls whether DTD validation errors are recoverable or fatal. |
|
HE PE EE |
true|false |
Forces Saxon to do eager evaluation of expressions in contexts where normally it would do lazy evaluation, for example when evaluating variables and function results. This can make for easier debugging. |
|
HE PE EE |
Name of a class implementing |
The class used whenever Saxon creates an |
|
HE PE EE |
Name of a class implementing EnvironmentVariableResolver |
Defines the environment variable resolver for all queries and transforms using this configuration. This affects the result of the XPath functions available-environment-variables() and environment-variable(). |
|
HE PE EE |
Name of a class implementing |
Defines the default |
|
HE PE EE |
true|false |
Controls whether attribute default values found in a DTD or schema are expanded or not. |
|
EE |
true|false |
Obsolete and ignored from Saxon 12.0. |
|
HE PE EE |
true|false |
Set to true to ignore the |
|
HE PE EE |
true|false |
Obsolete and ignored from Saxon 9.8. |
|
HE PE EE |
true|false |
Controls whether line and column number information is maintained for input files. |
|
HE PE EE |
true|false |
Indicates that Saxon should retain the fact that attributes are derived from defaults defined in a schema or DTD where this information is available from the XML parser. |
|
EE |
integer |
Obsolete and ignored from Saxon 12.0. |
|
EE |
true|false |
Obsolete and ignored from Saxon 12.0. |
|
HE PE EE |
string of flags or 0 |
Defines the level of code optimization to be applied. |
|
HE PE EE |
Name of a class that implements either the |
XML parser used for source documents. |
|
HE PE EE |
true|false |
If true, allows calls on doc() with a literal argument to be evaluated early, at compile time. |
|
HE PE EE |
true|false |
If true, query parameters such
as |
|
HE PE EE |
integer |
Sets a limit on the amount of backtracking performed during regular expression evaluation. |
|
HE PE EE |
Name of a class implementing ResourceResolver |
User-supplied class used to perform URI resolution. This resolver
is used at Configuration level, and may be supplemented by local
resolvers defined at task level, for example on an |
|
EE |
true|false |
Indicates that the location information held in the run-time expression tree should retain links to nodes in the original stylesheet tree. |
|
EE |
strict|lax|preserve|strip |
Controls whether schema validation is applied to input files. |
|
HE PE EE |
Name of a class that implements SerializerFactory |
Allows the serialization pipeline to be customized, for example to handle user-defined serialization parameters. |
|
HE PE EE |
Name of a class implementing the SourceResolver interface |
Name of a user-supplied class that resolves unknown implementations of the JAXP
|
|
HE PE EE |
true|false |
Indicates that collections read using the |
|
HE PE EE |
true|false |
Indicates that unparsed text files read using functions such as
|
|
HE PE EE |
A file name |
Redirects output which would otherwise go to the stardard error output stream
|
|
EE |
off|standard |
Determines the test applied to see if constructs are streamable (if streaming is requested). |
|
HE PE EE |
true|false |
If true, then constructs for which streaming is requested will be exectued in non-streaming mode if the code is not actually streamable. |
|
HE PE EE |
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). |
|
HE PE EE |
Name of a class implementing the |
XML parser used for stylesheets and schema documents. |
|
PE EE |
true|false |
Suppresses the warning issued to indicate that an evaluation license in use is due to expire. |
|
HE PE EE |
true|false |
Suppresses all warnings issued by the XPath and XQuery parsers. |
|
HE PE EE |
true|false |
Suppresses the warning when there is no commonality between the namespaces used in stylesheet match patterns and the namespaces used in the source document. |
|
EE |
integer |
Defines a limit on the size of user-defined functions that will be inlined. |
|
EE |
integer |
Obsolete and ignored from Saxon 12.0. |
|
HE PE EE |
true|false |
Outputs progress messages to |
|
PE EE |
true|false |
Provides diagnostics when external functions are dynamically loaded. |
|
HE PE EE |
Name of a class implementing TraceListener |
User-defined class to be used for handling run-time trace output. |
|
HE PE EE |
string (file name) |
Supplies a file as destination for trace listener output. |
|
PE EE |
true|false |
Causes tracing of decisions made by the optimizer. |
|
HE PE EE |
linkedTree|tinyTree| tinyTreeCondensed |
Determines the tree model implementation used for input files: TinyTree, LinkedTree, or TinyTree(condensed). |
|
HE PE EE |
Name of a class implementing the UnparsedTextURIResolver interface |
The class name of the |
|
HE PE EE |
Name of a class implementing the JAXP |
The |
|
HE PE EE |
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. |
|
EE |
true|false |
If true, typed values of element and attribute nodes are cached in the TinyTree. Uses extra memory, may make execution faster. |
|
EE |
true|false |
Only relevant when |
|
EE |
true|false |
For result trees subjected to schema validation, indicates whether validation failures should be treated as warnings rather than fatal errors. |
|
HE PE EE |
1.0|1.1 |
Determines whether XML 1.0 or XML 1.1 rules are used. |
|
HE PE EE |
true|false |
Controls whether XInclude processing is applied to input files. |
|
EE |
integer |
Defines what version of the XPath language may be used in XML Schema 1.1 assertions and type alternatives. |
|
HE PE EE |
integer |
Defines what version of the XPath language may be used in XSLT 3.0 stylesheets. |
|
EE |
string |
A regular expression used to decide whether a collection URI is to be treated as representing a ZIP file. The default pattern is "^jar:|\.jar$|\.zip$\.docx$\.xlsx$" which matches a URI that starts with "jar:" or that ends with ".jar", ".zip", ".docx", or ".xlsx". |