summaryrefslogtreecommitdiffstats
path: root/gxpm.1
blob: f5ce915b08aa84db7a3aa2342363c3920eb0a903 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
.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