From 8ad317c706d3b42fcc5852a9c12c55e13dfb109c Mon Sep 17 00:00:00 2001
From: david <david@e0a8ed71-7df4-0310-8962-fdc924857419>
Date: Thu, 16 Jul 2009 19:26:35 +0000
Subject: [PATCH] Add a description of XML output to the Ndiff man page. Still
 need to fill in the output examples.

---
 ndiff/docs/ndiff.xml | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/ndiff/docs/ndiff.xml b/ndiff/docs/ndiff.xml
index f738d4e0d..a3461037c 100644
--- a/ndiff/docs/ndiff.xml
+++ b/ndiff/docs/ndiff.xml
@@ -131,6 +131,34 @@
     <example id="ndiff-man-ex-text-output">
       <title>Ndiff text output</title>
 <screen>
+</screen>
+    </example>
+
+    <para>
+    XML output, intended to be processed by other programs, is selected
+    with the <option>--xml</option> option. It is based on Nmap's XML
+    output, with a few additional elements to indicate differences. The
+    XML document is enclosed in <varname>nmapdiff</varname> and
+    <varname>scandiff</varname> elements. Host differences are enclosed
+    in <varname>hostdiff</varname> tags and port differences are
+    enclosed in <varname>portdiff</varname> tags. Inside a
+    <varname>hostdiff</varname> or <varname>portdiff</varname>,
+    <varname>a</varname> and <varname>b</varname> tags show the state of
+    the host or port in the first scan (<varname>a</varname>) or the
+    second scan (<varname>b</varname>).
+    </para>
+
+    <para>
+    <xref linkend="ndiff-man-ex-xml-output"/> shows the XML diff of the
+    same scans shown above in
+    <xref linkend="ndiff-man-ex-text-output" xrefstyle="select: label"/>.
+    </para>
+
+    <example id="ndiff-man-ex-xml-output">
+      <title>Ndiff XML output</title>
+<screen>
+<![CDATA[
+]]>
 </screen>
     </example>
   </refsect1>