From: Richard W.M. Jones <rjones@redhat.com>
Date: Sat, 27 Aug 2011 16:53:03 +0000 (+0100)
Subject: inspector: Use xmlstarlet instead of xpath in examples.
X-Git-Tag: 1.12.5~1
X-Git-Url: http://git.annexia.org/?a=commitdiff_plain;h=86dad5c7f117dc05c730a1184a53b0ce38e62ed9;p=libguestfs.git

inspector: Use xmlstarlet instead of xpath in examples.
(cherry picked from commit baefb8225c8cbde56a1637c17af5c0965a81060e)
---

diff --git a/inspector/virt-inspector.pod b/inspector/virt-inspector.pod
index 5496827..df9dfda 100755
--- a/inspector/virt-inspector.pod
+++ b/inspector/virt-inspector.pod
@@ -329,22 +329,25 @@ installer, or one part of a multipart CD.  For example:
 
 =head1 USING XPATH
 
-You can use the XPath query language, and/or the xpath tool, in order
-to select parts of the XML.
+You can use the XPath query language to select parts of the XML.  We
+recommend using C<xmlstarlet> to perform XPath queries from the
+command line.
 
 For example:
 
- $ virt-inspector -d Guest | xpath //filesystems
- Found 1 nodes:
- -- NODE --
+ $ virt-inspector -d Guest | xmlstarlet sel -t -c '//filesystems'
  <filesystems>
       <filesystem dev="/dev/vg_f13x64/lv_root">
         <type>ext4</type>
- [etc]
+ [...]
 
  $ virt-inspector -d Guest | \
-     xpath "string(//filesystem[@dev='/dev/sda1']/type)"
- Query didn't return a nodeset. Value: ext4
+     xmlstarlet sel -t -c "string(//filesystem[@dev='/dev/sda1']/type)"
+ ext4
+
+ $ virt-inspector -d Guest | \
+    xmlstarlet sel -t -v '//icon' | base64 -i -d | display -
+ [displays the guest icon, if there is one]
 
 =head1 SHELL QUOTING
 
@@ -380,6 +383,7 @@ L<guestfs(3)>,
 L<guestfish(1)>,
 L<http://www.w3.org/TR/xpath/>,
 L<base64(1)>,
+L<xmlstarlet(1)>,
 L<http://libguestfs.org/>.
 
 =head1 AUTHORS