[amateur-radio-guide] Documentation for xwota

[John J. McDonough]

commit 50a72ad9448dd072bb6aa794f0bbb045cdae8706
Author: John J. McDonough <wb8rcr at arrl.net>
Date:   Mon Nov 8 20:58:28 2010 -0500

    Documentation for xwota

 en-US/Revision_History.xml                       |    1 +
 en-US/images/others-xwota/xwota-Query.png        |  Bin 0 -> 11699 bytes
 en-US/images/others-xwota/xwota-Station_Info.png |  Bin 0 -> 16693 bytes
 en-US/others-xwota.xml                           |   88 ++++++++++++++++++----
 4 files changed, 74 insertions(+), 15 deletions(-)
---
diff --git a/en-US/Revision_History.xml b/en-US/Revision_History.xml
index b823c12..5333ea6 100644
--- a/en-US/Revision_History.xml
+++ b/en-US/Revision_History.xml
@@ -24,6 +24,7 @@
 	    <member>Documentation for gEDA</member>
 	    <member>Documentation for gerbv</member>
 	    <member>Documentation for pcb</member>
+	    <member>Documentation for xwota</member>
 	  </simplelist>
 	</revdescription>
       </revision>
diff --git a/en-US/images/others-xwota/xwota-Query.png b/en-US/images/others-xwota/xwota-Query.png
new file mode 100644
index 0000000..1edf883
Binary files /dev/null and b/en-US/images/others-xwota/xwota-Query.png differ
diff --git a/en-US/images/others-xwota/xwota-Station_Info.png b/en-US/images/others-xwota/xwota-Station_Info.png
new file mode 100644
index 0000000..47f1ebd
Binary files /dev/null and b/en-US/images/others-xwota/xwota-Station_Info.png differ
diff --git a/en-US/others-xwota.xml b/en-US/others-xwota.xml
index 1259798..74b57ae 100644
--- a/en-US/others-xwota.xml
+++ b/en-US/others-xwota.xml
@@ -2,18 +2,76 @@
 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docarticle/xml/4.5/docarticlex.dtd" [
 ]>
 
-<section id="others-xwota">
-  <title>xwota</title>
-  <para>
-    <figure float="0"><title>Who is on the air</title>
-    <mediaobject>
-      <imageobject><imagedata scale="99" scalefit="1" fileref="images/others-xwota/xwota.png" format="PNG"/></imageobject>
-      <textobject><para>
-	Who is on the air
-      </para>
-      </textobject>
-    </mediaobject>
-    </figure>
-
-  </para>
-</section>
+  <section id="others-xwota">
+    <title>xwota</title>
+    <para>
+      <package>xwota</package> allows for monitoring and querying the WOTA
+      database.  It operates much like a DX Cluster client, except it uses the
+      database rather than a cluster.  Refer to <ulink type="http"
+	url="http://www.wotadb.org" /> for information about the WOTA database.
+    </para>
+    <para>
+      Selecting <guimenuitem>Connect</guimenuitem> from the
+      <guimenu>Xwota</guimenu> menu will connect to the database.  New reports
+      will appear on the screen as they arrive.
+    </para>
+    <para>
+      <figure float="0"><title>Who is on the air</title>
+	<mediaobject>
+	  <imageobject><imagedata scale="99" scalefit="1" fileref="images/others-xwota/xwota.png" format="PNG"/></imageobject>
+	  <textobject><para>
+	      Who is on the air
+	    </para>
+	  </textobject>
+	</mediaobject>
+      </figure>
+    </para>
+    <para>
+      The user may also query the database by selection
+      <guimenuitem>Query</guimenuitem> from the <guimenu>Show</guimenu> menu.  A
+      dialog will appear allowing the user to enter specific location,
+      frequency, and/or call to be searched for.  The results will be returned
+      at the bottom of the main menu.
+    </para>
+    <para>
+      <figure float="0"><title>Xwota query window</title>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata scale="99" scalefit="1"
+	    fileref="images/others-xwota/xwota-Query.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <para>
+	      Xwota query window
+	    </para>
+	  </textobject>
+	</mediaobject>
+      </figure>
+    </para>
+    <para>
+      The user may also enter his own report.  Before doing this, station
+      iformation should be entered by selecting <guimenuitem>Station
+      Info</guimenuitem> from the <guimenu>Settings</guimenu> menu and filling
+      in the dialog:
+    </para>
+    <para>
+      <figure float="0"><title>Station Info window</title>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata scale="50" scalefit="1"
+	    fileref="images/others-xwota/xwota-Station_Info.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <para>
+	      Station Info window
+	    </para>
+	  </textobject>
+	</mediaobject>
+      </figure>
+    </para>
+    <para>
+      The user may then enter the frequency and optionally a comment, and click
+      the <guilabel>Send</guilabel> button to cause the report to be sent to the
+      database. 
+    </para>
+  </section>