Make changes to manuals to (hopefully) improve documentation and to change

[spider.git] / sgml / usermanual.sgml

diff --git a/sgml/usermanual.sgml b/sgml/usermanual.sgml
index 5b17b0307507d54502cd340b01cb8d73cfa50206..470d137119435dd82e6a21a4865635ff46294fb6 100644 (file)
--- a/sgml/usermanual.sgml
+++ b/sgml/usermanual.sgml
@@ -4,9 +4,10 @@
 
 <!-- Title information -->
 
-<title>The DXSpider User Manual 
-<author>Ian Maude, G0VGS, (ianmaude@btinternet.com)
-<date>Version 1.0, March 2001
+<title>The DXSpider User Manual v1.49</title> 
+<author>Ian Maude, G0VGS, (g0vgs@ea1dav.net)</author>
+<date>December 2001 revision 4.1</date>
+
 <abstract>
 A complete reference for users of the DXSpider DXCluster program.
 </abstract>
@@ -339,7 +340,8 @@ show/sun
 The output from this would look something like this ..
 
 <tscreen><verb>
-sh/sun                                                                          Location                              Rise   Set      Azim   Elev
+sh/sun
+Location                              Rise   Set      Azim   Elev
 G0VGS  Morecambe, Lancashire          07:08Z 17:39Z  205.3   24.1
 </verb></tscreen>
 
@@ -350,7 +352,9 @@ sh/sun 5b4
 would look like this ...
 
 <tscreen><verb>
-sh/sun 5b4                                                                      Location                              Rise   Set      Azim   Elev               5B     Cyprus-5B                      04:23Z 15:40Z  244.0   18.8  
+sh/sun 5b4
+Location                              Rise   Set      Azim   Elev
+5B     Cyprus-5B                      04:23Z 15:40Z  244.0   18.8  
 </verb></tscreen>
 
 You can also specify multiple arguments like this ...
@@ -364,7 +368,8 @@ and then the output would look like this ...
 <tscreen><verb>
 sh/sun gw4veq 5b4ab zs
 Location                              Rise   Set      Azim   Elev
-GW4VEQ Brungwran, Isle of Anglesey IO 07:14Z 17:48Z  204.9   24.9               5B     Cyprus-5B                      04:23Z 15:40Z  244.5   18.3
+GW4VEQ Brungwran, Isle of Anglesey IO 07:14Z 17:48Z  204.9   24.9
+5B     Cyprus-5B                      04:23Z 15:40Z  244.5   18.3
 ZS     So-Africa-ZS1-ZS               04:31Z 17:28Z  289.9   41.3
 ZS     So-Africa-ZS5-ZS               03:44Z 16:34Z  278.5   32.0
 ZS     So-Africa-ZS6-ZS               03:59Z 16:42Z  277.6   35.0 
@@ -389,7 +394,7 @@ The output from this command would look like this ..
 
 <tscreen><verb>
 sh/moon ea
-Location                              Rise   Set      Azim   Elev RGain dB
+Location                              Rise   Set      Azim   Elev  RGain dB
 EA     Spain-EA                       08:15Z 20:09Z  257.2    9.5      -0.6  
 </verb></tscreen>
  
@@ -487,7 +492,7 @@ show/configuration (prefix)
 
 The first of our three examples would output something like this,
 
-<verb>
+<tscreen><verb>
 sh/c
 Node         Callsigns
 EI5TCR       (7 users)
@@ -508,7 +513,7 @@ GB7DXK       G1NTW        G3IBI        G3NSM        G3XAQ        G4CUS
              G4XQY        G7GAN
 GB7DXM       G1EUC        G3GAF        G3LAS        G4ZTR        G8WXU
              M0BCT        M1EMF
-</verb>
+</verb></tscreen>
 
 You will notice that EI5TCR is showing only that it has 7 users and not
 giving the actual callsigns.  This means that this node is on a limited
@@ -519,7 +524,7 @@ between nodes.
 The second example would just show the nodes connected in the
 network, like this,
 
-<verb>
+<tscreen><verb>
 sh/c/n
 Node         Callsigns
 GB7BAA       GB7BAA       GB7BPQ       (GB7CDX)     GB7DJK       GB7DXA      
@@ -530,19 +535,19 @@ GB7BIG       EI5TCR       GB7ADX       GB7BIG       GB7UDX
 GB7MBC                                                                       
 PA4AB-14     PA4AB-14                                                        
 PI4TUE-8     PI4TUE-8    
-</verb>
+</verb></tscreen>
 
 If we insert the node_call pi4tue-8 into the third example, then
 this would be the output,
 
-<verb>
+<tscreen><verb>
 Node         Callsigns
 PI4TUE-8     9A1CMA-6     DF6PW        DL4FAY       DL4KAK       DL4WF-2     
              F5NOD-2      F5PAC        IZ0CSR       N6CR         OH2BLD      
              ON1LVL-13    ON4CBT       ON4CJP       ON5DXL-14    ON7NQ       
              PA0RCT       PA3DYS       PA3FDO       PA5KW-4      PI4TUE-9    
              YT1XX        
-</verb>
+</verb></tscreen>
 
 As you can see, only the users of the requested node are shown.
 
@@ -565,11 +570,11 @@ show/users
 
 The output of this command would look like this,
 
-<verb>
+<tscreen><verb>
 Callsigns connected to GB7MBC
 G0JHC        G0NEI        G0VGS        G0VGS-2      G0YLM                    
 G3JAG        G3OWO        G3UEU
-</verb>
+</verb></tscreen>
 
 <sect>Talk mode.
 
@@ -990,9 +995,6 @@ can I be alerted when anything happens?
 <bf/A./Use the <bf>SET/BEEP</bf> command.  You can find information 
 on this in the "DXSpider Command Reference" section.
 
-<bf/Q./I keep getting disconnected from the cluster, what is
-happening and how can I stop it?
-
 <bf/Q./I got disconnected from the cluster and now I can't log
 back in again.  What is wrong?
 
@@ -1001,10 +1003,6 @@ will not let you reconnect using the same call to prevent loops.
 Try logging on again adding an ssid to your callsign as DXSpider
 treats G0YLM and G0YLM-1 as different users.
 
-<bf/Q./I notice that all the commands are shown in lower case in
-the main section of this manual, but in upper case in the "DXSpider 
-Command Reference" section.  Why is that?
-
 <bf/Q./How do I know if I have got the latest version of this
 user manual?
 
@@ -1077,7 +1075,7 @@ but this probably for advanced users...
 
 <P>
 <tt>
-<bf>accept/announce &lsqb;0-9&rsqb; &lt;pattern&gt;</bf> Set an accept filter 
+<bf>accept/spots &lsqb;0-9&rsqb; &lt;pattern&gt;</bf> Set an accept filter 
 line for spots
 </tt>
 
@@ -1900,6 +1898,33 @@ WWV messages with the <em>unset/wwv</em> command.
 Allow WX information to be seen at your console.  You can switch off
 WX messages with the <em>unset/wx</em> command.
 
+<sect1>show/configuration
+
+<P>
+<tt>
+<bf>show/configuration &lsqb;&lt;node&gt;&rsqb;</bf> Show all visible nodes and their users
+</tt>
+
+<P>
+This command allows you to see all the users that can be seen
+and the nodes to which they are connected.  With the optional <em>node</em>,
+you can specify a particular node to look at.
+
+This command is normally abbreviated to: sh/c
+
+BE WARNED: the list that is returned can be VERY long
+
+<sect1>show/configuration/node
+
+<P>
+<tt>
+<bf>show/configuration/node</bf> Show all the nodes connected
+</tt>
+
+<P>
+Show all the nodes connected locally and the nodes they have connected.
+
+
 <sect1>show/date 
 
 <P>