\" Automatically generated by Pandoc 2.3.1
\"
TH "xml\-merge" "1" "2020\-07\-07" "" "xml\-utils"
hy
SH NAME
PP
xml\-merge \- Merge XML files on a common element
SH SYNOPSIS
IP
nf
\f[C]
xml\-merge\ [\-fh?]\ <dst>\ <src>
\f[]
fi
SH DESCRIPTION
PP
The \f[I]xml\-merge\f[] utility merges two XML files together, based on
a common element.
SH OPTIONS
TP
B \-f, \-\-overwrite
Overwrite the <dst> file with the merged result, instead of writing to
stdout.
RS
RE
TP
B \-h, \-?, \-\-help
Show usage message.
RS
RE
TP
B \-\-version
Show version information.
RS
RE
TP
B <dst>
The XML file which <src> will be merged in to.
RS
RE
TP
B <src>
The XML file which will me merged in to <dst>.
The first occurence of an element in <dst> which matches the root
element of this file is where the merge will occur.
RS
RE
PP
In addition, the following options allow configuration of the XML
parser:
TP
B \-\-dtdload
Load the external DTD.
RS
RE
TP
B \-\-huge
Remove any internal arbitrary parser limits.
RS
RE
TP
B \-\-net
Allow network access to load external DTD and entities.
RS
RE
TP
B \-\-noent
Resolve entities.
RS
RE
TP
B \-\-xinclude
Do XInclude processing.
RS
RE
TP
B \-\-xml\-catalog <file>
Use an XML catalog when resolving entities.
Multiple catalogs may be loaded by specifying this option multiple
times.
RS
RE
SH EXAMPLE
PP
Given the following two XML files:
PP
\f[I]\f[CI]file1.xml\f[I]:\f[]
IP
nf
\f[C]
<root>
<metadata>...</metadata>
<content/>
</root>
\f[]
fi
PP
\f[I]\f[CI]file2.xml\f[I]:\f[]
IP
nf
\f[C]
<content>
<text>Hello\ world.</text>
</content>
\f[]
fi
PP
the xml\-merge utility will merge them on the element \f[C]content\f[]:
IP
nf
\f[C]
$\ xml\-merge\ file1.xml\ file2.xml\ >\ merged.xml
\f[]
fi
PP
to produce the merged file:
PP
\f[I]\f[CI]merged.xml\f[I]:\f[]
IP
nf
\f[C]
<root>
<metadata>...</metadata>
<content>
<text>Hello\ world.</text>
</content>
</root>
\f[]
fi
SH AUTHORS
khzae.net.
