<?xml version="1.0" encoding="iso-8859-1"?>
<?xml-stylesheet href="../../make-menu.xsl" type="text/xsl"?><html>
<head>
<this-is section="configuration" page="configuration-file" subpage="config-global"/>
<!--
Generated at 2011-12-09T20:47:22.916Z--><title>Saxonica: XSLT and XQuery Processing: The <global> element</title>
<meta name="coverage" content="Worldwide"/>
<meta name="copyright" content="Copyright Saxonica Ltd"/>
<meta name="title"
content="Saxonica: XSLT and XQuery Processing: The <global> element"/>
<meta name="robots" content="noindex,nofollow"/>
<link rel="stylesheet" href="../../saxondocs.css" type="text/css"/>
</head>
<body class="main">
<h1>The <global> element</h1>
<p>The <code>global</code> input element of the configuration file contains properties defining
global configuration options.</p>
<table>
<thead>
<tr>
<td content="para">
<p>
<b>Attribute</b>
</p>
</td>
<td content="para">
<p>
<b>Values</b>
</p>
</td>
<td content="para">
<p>
<b>Effect</b>
</p>
</td>
</tr>
</thead>
<tbody>
<tr>
<td content="para">
<p>allowExternalFunctions</p>
</td>
<td content="para">
<p>true|false</p>
</td>
<td content="para">
<p>True if calls to external Java or .NET functions are allowed</p>
</td>
</tr>
<tr>
<td content="para">
<p>allowMultiThreading</p>
</td>
<td content="para">
<p>true|false</p>
</td>
<td content="para">
<p>True if <code>saxon:threads</code> attribute on <code>xsl:for-each</code>
causes multi-threading under Saxon-EE; false to disable multi-threading. Default is true (but
multi-threading only happens if explicitly requested using <code>saxon:threads</code>.</p>
</td>
</tr>
<tr>
<td content="para">
<p>allowOldJavaUriFormat</p>
</td>
<td content="para">
<p>true|false</p>
</td>
<td content="para">
<p>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"</p>
</td>
</tr>
<tr>
<td content="para">
<p>collationUriResolver</p>
</td>
<td content="para">
<p>Name of a class implementing CollationURIResolver</p>
</td>
<td content="para">
<p>User-supplied class used to intepret collation URIs</p>
</td>
</tr>
<tr>
<td content="para">
<p>collectionUriResolver</p>
</td>
<td content="para">
<p>Name of a class implementing CollectionURIResolver</p>
</td>
<td content="para">
<p>User-supplied class used for resolving the URI supplied to the <code>collection()</code> function</p>
</td>
</tr>
<tr>
<td content="para">
<p>compileWithTracing</p>
</td>
<td content="para">
<p>true|false</p>
</td>
<td content="para">
<p>generates trace code in the expression tree, allowing a TraceListener to be used at run-time</p>
</td>
</tr>
<tr>
<td content="para">
<p>defaultCollation</p>
</td>
<td content="para">
<p>A collation URI</p>
</td>
<td content="para">
<p>(Requires Saxon-PE.) The collation URI to be used when no explicit collation is requested.</p>
</td>
</tr>
<tr>
<td content="para">
<p>defaultCollection</p>
</td>
<td content="para">
<p>A collection URI</p>
</td>
<td content="para">
<p>The collection URI to be used when no argument is passed to the <code>collection()</code> function.</p>
</td>
</tr>
<tr>
<td content="para">
<p>dtdValidation</p>
</td>
<td content="para">
<p>true|false</p>
</td>
<td content="para">
<p>Controls whether DTD validation is applied to input files.</p>
</td>
</tr>
<tr>
<td content="para">
<p>dtdValidationRecoverable</p>
</td>
<td content="para">
<p>true|false</p>
</td>
<td content="para">
<p>Controls whether DTD validation errors are recoverable or fatal.</p>
</td>
</tr>
<tr>
<td content="para">
<p>errorListener</p>
</td>
<td content="para">
<p>A Java class that implements javax.xml.transform.ErrorListener</p>
</td>
<td content="para">
<p>Defines the default ErrorListener for reporting both compile-time and run-time errors</p>
</td>
</tr>
<tr>
<td content="para">
<p>expandAttributeDefaults</p>
</td>
<td content="para">
<p>true|false</p>
</td>
<td content="para">
<p>Controls whether attribute default values found in a DTD or schema are expanded or not.</p>
</td>
</tr>
<tr>
<td content="para">
<p>lazyConstructionMode</p>
</td>
<td content="para">
<p>true|false</p>
</td>
<td content="para">
<p>If true, causes temporary trees to be constructed lazily</p>
</td>
</tr>
<tr>
<td content="para">
<p>lineNumbering</p>
</td>
<td content="para">
<p>true|false</p>
</td>
<td content="para">
<p>Controls whether line and column number information is maintained for input files</p>
</td>
</tr>
<tr>
<td content="para">
<p>optimizationLevel</p>
</td>
<td content="para">
<p>integer, 0 to 10</p>
</td>
<td content="para">
<p>Defines the level of code optimization to be applied</p>
</td>
</tr>
<tr>
<td content="para">
<p>preEvaluateDocFunction</p>
</td>
<td content="para">
<p>true|false</p>
</td>
<td content="para">
<p>If true, allows calls on <code>doc()</code> with a literal argument to be
evaluated early, at compile time</p>
</td>
</tr>
<tr>
<td content="para">
<p>preferJaxpParser</p>
</td>
<td content="para">
<p>true|false</p>
</td>
<td content="para">
<p>Relevant only on .NET, determines whether the Java Classpath parser is used in preference to the Microsoft .NET parser</p>
</td>
</tr>
<tr>
<td content="para">
<p>recognizeUriQueryParameters</p>
</td>
<td content="para">
<p>true|false</p>
</td>
<td content="para">
<p>If true, and the standard URIResolver is in use, query parameters such as <code>val=strict</code>
will be recognized on URIs supplied to the <code>doc</code> or <code>document()</code> functions.</p>
</td>
</tr>
<tr>
<td content="para">
<p>schemaValidation</p>
</td>
<td content="para">
<p>strict|lax|preserve|skip</p>
</td>
<td content="para">
<p>Controls whether schema validation is applied to input files</p>
</td>
</tr>
<tr>
<td content="para">
<p>serializerFactory</p>
</td>
<td content="para">
<p>Java class that extends net.sf.saxon.event.SerializerFactory</p>
</td>
<td content="para">
<p>Allows the serialization pipeline to be customized, for example to handle user-defined serialization parameters</p>
</td>
</tr>
<tr>
<td content="para">
<p>sourceParser</p>
</td>
<td content="para">
<p>Java class implementing XMLReader</p>
</td>
<td content="para">
<p>The SAX parser to be used for reading source files.</p>
</td>
</tr>
<tr>
<td content="para">
<p>sourceResolver</p>
</td>
<td content="para">
<p>Java class name implementing net.sf.saxon.SourceResolver</p>
</td>
<td content="para">
<p>Name of a user-supplied class that resolves unknown implementations of the JAXP Source class into a known implementation.</p>
</td>
</tr>
<tr>
<td content="para">
<p>stripWhitespace</p>
</td>
<td content="para">
<p>all|none|ignorable</p>
</td>
<td content="para">
<p>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)</p>
</td>
</tr>
<tr>
<td content="para">
<p>styleParser</p>
</td>
<td content="para">
<p>Java Class implementing XMLReader</p>
</td>
<td content="para">
<p>XML parser used for stylesheets and schema documents</p>
</td>
</tr>
<tr>
<td content="para">
<p>timing</p>
</td>
<td content="para">
<p>true|false</p>
</td>
<td content="para">
<p>Outputs progress messages to System.err. Equivalent to the -t option on the command line</p>
</td>
</tr>
<tr>
<td content="para">
<p>traceExternalFunctions</p>
</td>
<td content="para">
<p>true|false</p>
</td>
<td content="para">
<p>Provides diagnostics when external functions are dynamically loaded</p>
</td>
</tr>
<tr>
<td content="para">
<p>traceListener</p>
</td>
<td content="para">
<p>Java Class implementing net.sf.saxon.trace.TraceListener</p>
</td>
<td content="para">
<p>User-defined class to be used for handling run-time trace output</p>
</td>
</tr>
<tr>
<td content="para">
<p>traceOptimizerDecisions</p>
</td>
<td content="para">
<p>true|false</p>
</td>
<td content="para">
<p>Causes tracing of decisions made by the optimizer</p>
</td>
</tr>
<tr>
<td content="para">
<p>treeModel</p>
</td>
<td content="para">
<p>linkedTree|tinyTree|tinyTreeCondensed</p>
</td>
<td content="para">
<p>Determines the tree model implementation used for input files: TinyTree, LinkedTree, or TinyTree(condensed)</p>
</td>
</tr>
<tr>
<td content="para">
<p>uriResolver</p>
</td>
<td content="para">
<p>Name of a JAXP URIResolver</p>
</td>
<td content="para">
<p>The URIResolver to be used for deferencing URIs used in <code>xsl:include</code>, <code>xsl:import</code>,
<code>doc()</code>, and <code>document()</code>.</p>
</td>
</tr>
<tr>
<td content="para">
<p>usePiDisableOutputEscaping</p>
</td>
<td content="para">
<p>true|false</p>
</td>
<td content="para">
<p>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</p>
</td>
</tr>
<tr>
<td content="para">
<p>useTypedValueCache</p>
</td>
<td content="para">
<p>true|false</p>
</td>
<td content="para">
<p>If true, typed values of element and attribute nodes are cached in the TinyTree. Uses extra memory, may make
execution faster.</p>
</td>
</tr>
<tr>
<td content="para">
<p>validationComments</p>
</td>
<td content="para">
<p>true|false</p>
</td>
<td content="para">
<p>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.</p>
</td>
</tr>
<tr>
<td content="para">
<p>validationWarnings</p>
</td>
<td content="para">
<p>true|false</p>
</td>
<td content="para">
<p>For result trees subjected to schema validation, indicates whether validation failures should be treated as warnings
rather than fatal errors.</p>
</td>
</tr>
<tr>
<td content="para">
<p>versionOfXml</p>
</td>
<td content="para">
<p>1.0|1.1</p>
</td>
<td content="para">
<p>Determines whether XML 1.0 or XML 1.1 rules are used for names. (1.0 means the rules before Edition 5)</p>
</td>
</tr>
<tr>
<td content="para">
<p>xInclude</p>
</td>
<td content="para">
<p>true|false</p>
</td>
<td content="para">
<p>Controls whether XInclude processing is applied to input files</p>
</td>
</tr>
</tbody>
</table>
<table width="100%">
<tr>
<td>
<p align="right"><a class="nav" href="config-xslt.xml">Next</a></p>
</td>
</tr>
</table>
</body>
</html>
