XInclude Command Line Reference
XInclude.exe is the XmlPrime command line XInclude processor.
The command-line options are case sensitive.
XInclude.exe [Options] [Input] [Parameters]
Arguments
Argument | Description |
---|---|
Input |
The path to the input XML file. A single "-" character indicates that the query should be read from the standard input stream. |
Options
Option | Alias | Description |
---|---|---|
--dtd |
-d |
Enables the use of DTDs to validate input documents. By default, documents are not validated against their DTDs. Note that the DTDs are retrieved even when this option is disabled, as they are used to resolve entity references. |
--emacs |
Output errors and warnings in a single line format. | |
--fixup option |
-f option |
Specifies XInclude fixup options. The option may take one of the following values.
|
--help |
-? |
Displays usage instructions for the command line tool. |
-o filename |
|
Specifies a file to which the serialized output should be written. If the file already exists it is overwritten, otherwise a new file is created. If this option is omitted then the output of the query is sent to the standard output. |
--preserve |
|
Preserves all white space text nodes in all input documents. This cannot be used in conjunction with the --strip option.
|
--schema |
-v |
Validates input documents with XML Schema against the available schemas. All documents passed in on the command line or read by the transformation are validated against the available schemas. The available schemas used for validation contain:
Note that this does not affect validate expressions, which will only validate against schemas imported in the query. |
--strip |
|
Strips insignificant whitespace text nodes from all input documents. This cannot be used in conjunction with the --preserve option. |
--time |
-t |
Displays the time taken to serialize the output. |
---xsd schema |
-x schema |
Specifies the filename of an XML Schema to be added to the set of schemas available for validation. This mechanism also specifies the location of schemas imported in the query with no location hints. If the query imports a schema with the same namespace, then the schema supplied on the command line is used, regardless of which location hints are used. |
--noxsiloc |
|
Prevents schemas referenced by |
--version |
|
This option causes version information to be output to the console. |
Parameters
Parameter | Description |
---|---|
parametername=expression |
Sets a query parameter to the specified value.
A query parameter is the definition of a global variable declared as
The parametername is the local name of the parameter to be set.
The parameter is assumed to have no namespace.
An external variable declared with a namespace can be referred to with the syntax
expression is an XQuery expression that matches the ExprSingle production in the XQuery grammar. This is the same as the syntax that is valid for the definition of a global variable in an XQuery program. |
+parametername=document |
Sets a query parameter to the specified document.
A query parameter is the definition of a global variable declared as
The parametername is the local name of the parameter to be set.
The parameter is assumed to have no namespace.
An external variable declared with a namespace can be referred to with the syntax
document is a path or URI to an XML document. |
!parameter=value=value |
Sets a serialization parameter. Serialization parameters define how the result of the query is serialized. This is equivalent to adding the following declarations to the query: declare namespace serialization="http://www.xmlprime.com/serialization"; declare option serialization:parameter "value"; If the requested serialization parameter does not exist this parameter is ignored. If a parameter is also set in the query, then the value passed on the command line takes precedence. For a detailed description of all the available serialization parameters, see Serialization parameters. |