.TH GXPM 1 "3 July 2008"
.SH NAME
gxpm \- Merge XML documents using XPath expressions
.SH SYNOPSIS
\fBgxpm\fR [\fIoptions\fR] \fIXPATH\fR [\fIFILE\fR...] < \fIXML\fR
.SH DESCRIPTION

.B Gxpm
takes an XML document from standard input and merges into \fIFILE\fR
as a child of the locations which match XPATH.  Changes are done in-place
to \fIFILE\fR.

.SH OPTIONS

.TP
.BI \-p " PRE"
The prefix to use in the XPath expression to match the default XML
name space in the document.  XPath 1.0 does not define a way to match
the default name space when an XML document contains XML name spaces.
By specifying a default name space prefix here, you can match on the
default prefix in the document.

.SH EXAMPLES
.nf
.B Example document
<A>
 <B name="foo">
  <C>C of foo</C>
 </B>
 <B name="bar">
  <C>C of bar</C>
 </B>
 <B name="baz">
  <C>C of baz</C>
 </B>
</A>

.B # echo '<B name="frank"/>' | gxpm '/A' example.xml
.B # cat example.xml
<?xml version="1.0"?>
<A>
 <B name="foo">
  <C>C of foo</C>
 </B>
 <B name="bar">
  <C>C of bar</C>
 </B>
 
<B name="frank"/></A>

.fi

.SH "SEE ALSO"
gxpp(1), gxpd(1), grep(1), http://www.w3.org/TR/xpath