Update manuals for CVS and new commands
[spider.git] / sgml / adminmanual_en.sgml
index 5b571eb26c0d820cacfac03c4f7615249e947ed6..ea3f8146194c19b5e94becf3450908004bda4bcd 100644 (file)
@@ -4,10 +4,10 @@
 \r
 <!-- Title information -->\r
 \r
-<title>The DXSpider Administration Manual v1.50</title> \r
+<title>The DXSpider Administration Manual v1.51</title> \r
 <author>Ian Maude, G0VGS, (g0vgs@gb7mbc.net), and\r
 Charlie Carroll, K1XX, (k1xx@ptcnh.net)</author>\r
-<date>March 2003 revision 0.5</date>\r
+<date>June 2004 revision 1</date>\r
 \r
 <abstract>\r
 A reference for SysOps of the DXSpider DXCluster program.\r
@@ -584,6 +584,14 @@ would like to forward only spots across a link (maybe during a contest
 for example).  To do this, isolate the node in the normal way and use\r
 an <em>acc/spot &gt;call&lt; all</em> filter to override the isolate. \r
 \r
+<sect1>A DXSpider Filtering Tutorial\r
+\r
+<P>\r
+There is now an excellent primer/tutorial on filtering written by Jim\r
+Samuels, W3BG with an introduction by Dave Hawes N3RD that I strongly\r
+suggest you read.  You can read it here \r
+<htmlurl url="filtering_en.html" name="The DXSpider User Filtering Primer">\r
+\r
 <sect>Other filters\r
 \r
 <sect1>Filtering Mail\r
@@ -1659,7 +1667,7 @@ The next step will create a brand new 'spider' directory in your current
 directory.\r
 \r
 <verb>\r
-cvs -z3 -d:pserver:anonymous@cvs.DXSpider.sourceforge.net:/cvsroot/dxspider co spider\r
+cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/dxspider co spider\r
 </verb>\r
 \r
 This command is all on one line.\r
@@ -1811,8 +1819,7 @@ Click OK on the Update Settings dialog box
 Restart your Spider software\r
 </verb></tscreen>\r
 \r
-<sect>The DXSpider command set\r
-\r
+<sect>The DXSpider Command Reference\r
 \r
 <sect1>accept (0)
 
@@ -2219,6 +2226,60 @@ This will disconnect you from the cluster
 </tt>
 
 <P>
+<sect1>chat &lt;group&gt; &lt;text&gt; (0)
+
+<P>
+<tt>
+<bf>chat &lt;group&gt; &lt;text&gt;</bf> Chat or Conference to a group
+</tt>
+
+<P>
+It is now possible to JOIN a group and have network wide conferencing to that
+group. DXSpider does not (and probably will not) implement the AK1A 
+conference mode as this seems very limiting, is hardly used and doesn't seem
+to work too well anyway.
+
+This system uses the existing ANN system and is compatible with both other
+DXSpider nodes and AK1A clusters (they use ANN/&lt;group&gt;). 
+
+You can be a member of as many "groups" as you want. To join a group type:-
+
+<tscreen><verb>
+  JOIN FOC    (where FOC is the group name)
+</verb></tscreen>
+
+To leave a group type:-
+
+<tscreen><verb>
+  LEAVE FOC
+</verb></tscreen>
+
+You can see which groups you are in by typing:-
+
+<tscreen><verb>
+  STAT/USER
+</verb></tscreen>
+
+and you can see whether your mate is in the group, if he connects to the
+same node as you, by typing:-
+
+<tscreen><verb>
+  STAT/USER g1tlh
+</verb></tscreen>
+
+To send a message to a group type:-
+
+<tscreen><verb>
+  CHAT FOC hello everyone
+</verb></tscreen>
+
+or
+
+<tscreen><verb>
+  CH #9000 hello I am back
+</verb></tscreen>
+
+See also JOIN, LEAVE, SHOW/CHAT
 <sect1>clear/announce &lt;callsign&gt; &lsqb;input&rsqb; &lsqb;0-9|all&rsqb; (8)
 
 <P>
@@ -3098,6 +3159,22 @@ node&gt;).
 
 Best of luck - you will need it.
   
+<sect1>join &lt;group&gt; (0)
+
+<P>
+<tt>
+<bf>join &lt;group&gt;</bf> Join a chat or conference group
+</tt>
+
+<P>
+JOIN allows you to join a network wide conference group. To join a
+group (called FOC in this case) type:-
+
+<tscreen><verb>
+  JOIN FOC
+</verb></tscreen>
+
+See also CHAT, LEAVE, SHOW/CHAT
 <sect1>kill (5)
 
 <P>
@@ -3235,6 +3312,22 @@ Remove this message from the entire cluster system as well as your node.
 </tt>
 
 <P>
+<sect1>leave &lt;group&gt; (0)
+
+<P>
+<tt>
+<bf>leave &lt;group&gt;</bf> Leave a chat or conference group
+</tt>
+
+<P>
+LEAVE allows you to leave a network wide conference group. To leave a
+group (called FOC in this case) type:-
+
+<tscreen><verb>
+  LEAVE FOC
+</verb></tscreen>
+
+See also CHAT, JOIN, SHOW/CHAT
 <sect1>links (0)
 
 <P>
@@ -4221,8 +4314,8 @@ You can potentially connect several nodes in this way.
 
 <P>
 You can select the language that you want the cluster to use. Currently
-the languages available are en (English), de (German), es (Spanish) 
-and nl (Dutch).
+the languages available are en (English), de (German), es (Spanish),
+Czech (cz), French (fr), Portuguese (pt), Italian (it) and nl (Dutch).
 <sect1>set/location &lt;lat & long&gt; (0)
 
 <P>
@@ -4586,6 +4679,18 @@ for more information.
 <P>
 Display all the bad words in the system, see SET/BADWORD
 for more information.
+<sect1>show/chat &lsqb;&lt;group&gt;&rsqb; &lsqb;&lt;lines&gt;&rsqb; (0)
+
+<P>
+<tt>
+<bf>show/chat &lsqb;&lt;group&gt;&rsqb; &lsqb;&lt;lines&gt;&rsqb;</bf> Show any chat or conferencing 
+</tt>
+
+<P>
+This command allows you to see any chat or conferencing that has  
+occurred whilst you were away. SHOW/CHAT on its own will show data for
+all groups. If you use a group name then it will show only chat for
+that group.
 <sect1>show/configuration &lsqb;&lt;node&gt;&rsqb; (0)
 
 <P>
@@ -4769,7 +4874,50 @@ any order to the basic SHOW/DX command, they are:-
                    You can also use this with the 'by' keyword so 
                    eg by W dxcc  
 </verb></tscreen>
-   
+<tscreen><verb>
+ real or rt      - Format the output the same as for real time spots. The
+                   formats are deliberately different (so you can tell
+                   one sort from the other). This is useful for some 
+                   logging programs that can't cope with normal sh/dx 
+                   output. An alias of SHOW/FDX is available.
+</verb></tscreen>
+       
+<tscreen><verb>
+ filter          - Filter the spots, before output, with the user's 
+                   spot filter. An alias of SHOW/MYDX is available.
+</verb></tscreen>
+
+<tscreen><verb>
+ zone &lt;zones&gt;    - look for spots in the cq zone (or zones) specified.
+                   zones are numbers separated by commas.
+</verb></tscreen>
+
+<tscreen><verb>
+ by_zone &lt;zones&gt; - look for spots spotted by people in the cq zone
+                   specified.
+</verb></tscreen>
+
+<tscreen><verb>
+ itu &lt;itus&gt;      - look for spots in the itu zone (or zones) specified
+                   itu zones are numbers separated by commas.
+</verb></tscreen>
+
+<tscreen><verb>
+ by_itu &lt;itus&gt;   - look for spots spotted by people in the itu zone
+                   specified.
+</verb></tscreen>
+  
+<tscreen><verb>
+ state &lt;list&gt;    - look for spots in the US state (or states) specified
+                   The list is two letter state codes separated by commas.
+</verb></tscreen>
+
+<tscreen><verb>
+ by_state &lt;list&gt; - look for spots spotted by people in the US state
+                   specified.
+</verb></tscreen>
 <tscreen><verb>
  e.g. 
 </verb></tscreen>
@@ -4784,6 +4932,10 @@ any order to the basic SHOW/DX command, they are:-
    SH/DX qra jn86
    SH/DX dxcc oq2
    SH/DX dxcc oq2 by w dxcc
+   SH/DX zone 4,5,6
+   SH/DX by_zone 4,5,6
+   SH/DX state in,oh
+   SH/DX by_state in,oh
 </verb></tscreen>
   
 <sect1>show/dxcc &lt;prefix&gt; (0)
@@ -4815,6 +4967,7 @@ This can be done with the SHOW/DX command like this:-
    SH/DX dxcc w on 20m iota
 </verb></tscreen>
 
+This is an alias for: SH/DX dxcc
 <sect1>show/dxqsl &lt;callsign&gt; (0)
 
 <P>
@@ -4854,6 +5007,20 @@ This gives you more background information.
 <P>
 Show the total DX spots for the last &lt;days&gt; no of days (default is 31), 
 starting from a &lt;date&gt; (default: today).
+<sect1>show/fdx (0)
+
+<P>
+<tt>
+<bf>show/fdx</bf> Show the DX data in realtime format.
+</tt>
+
+<P>
+Normally SHOW/DX outputs spot data in a different format to the
+realtime data. This is a deliberate policy (so you can tell the 
+difference between the two). Some logging programs cannot handle
+this so SHOW/FDX outputs historical data in real time format.
+
+This is an alias for: SHOW/DX real
 <sect1>show/files &lsqb;&lt;filearea&gt; &lsqb;&lt;string&gt;&rsqb;&rsqb; (0)
 
 <P>
@@ -5113,6 +5280,25 @@ propagation data.
 Gives you an estimate of the long path propagation characterics. It
 should be noted that the figures will probably not be very useful, nor
 terrible accurate, but it is included for completeness.
+<sect1>show/mydx (0)
+
+<P>
+<tt>
+<bf>show/mydx</bf> Show the DX data filtered with your spot filter.
+</tt>
+
+<P>
+SHOW/DX potentially shows all the spots available in the system. Using
+SHOW/MYDX will, instead, filter the availble spots using any spot filter 
+that you have set, first. 
+
+This command, together with ACCEPT/SPOT or REJECT/SPOT, will allow
+you to customise the spots that you receive.
+
+So if you have said: ACC/SPOT on hf
+
+Doing a SHOW/MYDX will now only, ever, show HF spots. All the other 
+options on SH/DX can still be used.
 <sect1>show/newconfiguration &lsqb;&lt;node&gt;&rsqb; (0)
 
 <P>