add set/dxcq and set/dxitu commands
[spider.git] / cmd / Commands_en.hlp
index 66194e1bab3e6e9cf7fcf64ee180c720581e2059..6a5131980a17849bd3052ad3d15f1083397bc58e 100644 (file)
@@ -286,7 +286,7 @@ remove the whole filter.
 
 see CLEAR/SPOTS for a more detailed explanation.
 
-=== 8^CLEAR/ANNOUNCE [input] <callsign> [0-9|all]^Clear a announce filter line
+=== 8^CLEAR/ANNOUNCE <callsign> [input] [0-9|all]^Clear a announce filter line
 A sysop can clear an input or normal output filter for a user or the
 node_default or user_default. 
 
@@ -296,7 +296,7 @@ remove the whole filter.
 
 see CLEAR/SPOTS for a more detailed explanation.
 
-=== 8^CLEAR/ROUTE [input] <callsign> [0-9|all]^Clear a route filter line
+=== 8^CLEAR/ROUTE <callsign> [input] [0-9|all]^Clear a route filter line
 A sysop can clear an input or normal output filter for a user or the
 node_default or user_default. 
 
@@ -323,7 +323,7 @@ If you do:
 
 the filter will be completely removed.
 
-=== 8^CLEAR/SPOTS [input] <callsign> [0-9|all]^Clear a spot filter line
+=== 8^CLEAR/SPOTS <callsign> [input] [0-9|all]^Clear a spot filter line
 A sysop can clear an input or normal output filter for a user or the
 node_default or user_default. 
 
@@ -333,7 +333,7 @@ remove the whole filter.
 
 see CLEAR/SPOTS for a more detailed explanation.
 
-=== 8^CLEAR/WCY [input] <callsign> [0-9|all]^Clear a WCY filter line
+=== 8^CLEAR/WCY <callsign> [input] [0-9|all]^Clear a WCY filter line
 A sysop can clear an input or normal output filter for a user or the
 node_default or user_default. 
 
@@ -343,7 +343,7 @@ remove the whole filter.
 
 see CLEAR/SPOTS for a more detailed explanation.
 
-=== 8^CLEAR/WWV [input] <callsign> [0-9|all]^Clear a WWV filter line
+=== 8^CLEAR/WWV <callsign> [input] [0-9|all]^Clear a WWV filter line
 A sysop can clear an input or normal output filter for a user or the
 node_default or user_default. 
 
@@ -1392,17 +1392,39 @@ will allow text with this word again.
 === 9^UNSET/DEBUG <name>^Remove a debug level from the debug set
 You can choose to log several different levels.  The levels are
 
-chan
-state
-msg
-cron
-connect
+ chan
+ state
+ msg
+ cron
+ connect
 
 You can show what levels you are logging with SHOW/DEBUG
 
 === 0^SET/DX^Allow DX messages to come out on your terminal
 === 0^UNSET/DX^Stop DX messages coming out on your terminal
 
+=== 0^SET/DXCQ^Show CQ Zones on the end of DX announcements
+=== 0^UNSET/DXCQ^Stop CQ Zones on the end of DX announcements
+Display both the Spotter's and the Spotted's CQ Zone on the end
+of a DX announcement (there is just enough room). Some user programs
+cannot cope with this. The Spotter's CQ is on the RHS of the 
+time, the Spotted's CQ is on the LHS.
+
+Conflicts with: SHOW/DXGRID, SHOW/DXITU, SHOW/USSTATE
+
+Do a STAT/USER to see which flags you have set if you are confused.  
+
+=== 0^SET/DXITU^Show ITU Zones on the end of DX announcements
+=== 0^UNSET/DXITU^Stop ITU Zones on the end of DX announcements
+Display both the Spotter's and the Spotted's ITU Zone on the end
+of a DX announcement (there is just enough room). Some user programs
+cannot cope with this. The Spotter's ITU is on the RHS of the 
+time, the Spotted's ITU is on the LHS.
+
+Conflicts with: SHOW/DXGRID, SHOW/DXCQ, SHOW/USSTATE
+
+Do a STAT/USER to see which flags you have set if you are confused.  
+
 === 0^SET/DXGRID^Allow QRA Grid Squares on the end of DX announcements
 === 0^UNSET/DXGRID^Stop QRA Grid Squares on the end of DX announcements
 A standard feature which is enabled in version 1.43 and above is 
@@ -1411,6 +1433,10 @@ of a DX announcement (there is just enough room). Some user programs
 cannot cope with this. You can use this command to reset (or set)
 this feature.
 
+Conflicts with: SHOW/DXCQ, SHOW/DXITU
+
+Do a STAT/USER to see which flags you have set if you are confused.  
+
 === 5^SET/DXNET <call> [<call>..]^Make the callsign an DXNet node
 
 === 0^SET/ECHO^Make the cluster echo your input
@@ -1668,6 +1694,23 @@ overwritten by any weekly updates that affect this callsign
 
 see also DELETE/USDB
 
+=== 0^SET/USSTATE^Allow US State info on the end of DX announcements
+=== 0^UNSET/USSTATE^Stop US State info on the end of DX announcements
+If the spotter's or spotted's US State is known it is output on the 
+end of a DX announcement (there is just enough room). 
+
+A spotter's state will appear on the RHS of the time (like 
+SET/DXGRID) and the spotted's State will appear on the LHS of the
+time field. Any information found will override any locator 
+information from SET/DXGRID.
+
+Some user programs cannot cope with this. You can use this command 
+to reset (or set) this feature.
+
+Conflicts with: SHOW/DXCQ, SHOW/DXITU
+
+Do a STAT/USER to see which flags you have set if you are confused.  
+
 === 0^SET/WCY^Allow WCY messages to come out on your terminal
 === 0^UNSET/WCY^Stop WCY messages coming out on your terminal
 
@@ -1699,8 +1742,23 @@ and the nodes to which they are connected.
 
 This command is normally abbreviated to: sh/c
 
+Normally, the list returned will be just for the nodes from your 
+country (because the list otherwise will be very long).
+
+  SH/C ALL 
+
+will produce a complete list of all nodes. 
+
 BE WARNED: the list that is returned can be VERY long
 
+It is possible to supply a node or part of a prefix and you will get 
+a list of the users for that node or list of nodes starting with
+that prefix.
+
+  SH/C GB7DJK
+
+  SH/C SK
+
 === 0^SHOW/CONFIGURATION/NODE^Show all the nodes connected locally
 Show all the nodes connected to this node.
 
@@ -1717,6 +1775,13 @@ time and UTC as the computer has it right now. If you give some prefixes
 then it will show UTC and UTC + the local offset (not including DST) at
 the prefixes or callsigns that you specify.
 
+=== 0^SHOW/DB0SDX <callsign>^Show QSL infomation from DB0SDX database
+This command queries the DB0SDX QSL server on the internet
+and returns any information available for that callsign. This service
+is provided for users of this software by http://www.qslinfo.de.
+
+See also SHOW/QRZ, SHOW/WM7D.
+
 === 9^SHOW/DEBUG^Show what levels of debug information you are logging
 
 === 0^SHOW/DX^Interrogate the spot database
@@ -1726,47 +1791,47 @@ If you just type SHOW/DX you will get the last so many spots
 In addition you can add any number of these commands in very nearly
 any order to the basic SHOW/DX command, they are:-
    
-on <band>       - eg 160m 20m 2m 23cm 6mm
-on <region>     - eg hf vhf uhf shf      (see SHOW/BANDS)
-on <from>/<to>  - eg 1000/4000 14000-30000  (in Khz)
-   <from>-<to>
+ on <band>       - eg 160m 20m 2m 23cm 6mm
+ on <region>     - eg hf vhf uhf shf      (see SHOW/BANDS)
+ on <from>/<to>  - eg 1000/4000 14000-30000  (in Khz)
+    <from>-<to>
    
-<number>        - the number of spots you want
-<from>-<to>     - <from> spot no <to> spot no in the selected list
-<from>/<to>
+ <number>        - the number of spots you want
+ <from>-<to>     - <from> spot no <to> spot no in the selected list
+ <from>/<to>
    
-<prefix>        - for a spotted callsign beginning with <prefix>
-*<suffix>       - for a spotted callsign ending in <suffix>
-*<string>*      - for a spotted callsign containing <string>
+ <prefix>        - for a spotted callsign beginning with <prefix>
+ *<suffix>       - for a spotted callsign ending in <suffix>
+ *<string>*      - for a spotted callsign containing <string>
    
-day <number>    - starting <number> days ago
-day <from>-<to> - <from> days <to> days ago
-    <from>/<to>   
+ day <number>    - starting <number> days ago
+ day <from>-<to> - <from> days <to> days ago
+     <from>/<to>   
 
-info <text>     - any spots containing <text> in the info or remarks
-   
-by <call>       - any spots spotted by <call> (spotter <call> is the 
-                  same).
+ info <text>     - any spots containing <text> in the info or remarks
+    
+ by <call>       - any spots spotted by <call> (spotter <call> is the 
+                   same).
 
-qsl             - this automatically looks for any qsl info on the call
-                  held in the spot database.
+ qsl             - this automatically looks for any qsl info on the call
+                   held in the spot database.
 
-iota [<iota>]   - If the iota island number is missing it will look for
+ iota [<iota>]   - If the iota island number is missing it will look for
                   the string iota and anything which looks like an iota
                   island number. If you specify then it will look for  
                   that island.
 
-qra [<locator>] - this will look for the specific locator if you specify
-                  one or else anything that looks like a locator.
+ qra [<locator>] - this will look for the specific locator if you specify
+                   one or else anything that looks like a locator.
 
-dxcc            - treat the prefix as a 'country' and look for spots
-                  from that country regardless of actual prefix.
-                  eg dxcc oq2 
+ dxcc            - treat the prefix as a 'country' and look for spots
+                   from that country regardless of actual prefix.
+                   eg dxcc oq2 
                   
-                  You can also use this with the 'by' keyword so 
-                  eg by W dxcc  
+                   You can also use this with the 'by' keyword so 
+                   eg by W dxcc  
    
-e.g. 
+ e.g. 
    
    SH/DX 9m0
    SH/DX on 20m info iota
@@ -1796,8 +1861,9 @@ This can be done with the SHOW/DX command like this:-
    SH/DX dxcc g
    SH/DX dxcc w on 20m iota
 
-=== 0^SHOW/DXSTATS^Show the DX Statistics for last 31 days
-Show the total DX spots for the last 31 days
+=== 0^SHOW/DXSTATS [days] [date]^Show the DX Statistics
+Show the total DX spots for the last <days> no of days (default is 31), 
+starting from a <date> (default: today).
 
 === 0^SHOW/FILES [<filearea> [<string>]]^List the contents of a filearea
 SHOW/FILES on its own will show you a list of the various fileareas
@@ -1817,12 +1883,15 @@ See also TYPE - to see the contents of a file.
 Show the contents of all the filters that are set. This command displays
 all the filters set - for all the various categories.
 
-=== 0^SHOW/HFSTATS^Show the HF DX Statistics for last 31 days 
-Show the HF DX spots breakdown by band for the last 31 days
+=== 0^SHOW/HFSTATS [days] [date]^Show the HF DX Statistics 
+Show the HF DX spots breakdown by band for the last <days> no of days 
+(default is 31), starting from a <date> (default: today).
 
-=== 0^SHOW/HFTABLE [prefix ...]^Show the HF DX Spotter Table
-Show the HF DX Spotter table for the list of prefixes for the last 31 days,
-if there are no prefixes then it will show the table for your country.
+=== 0^SHOW/HFTABLE [days] [date] [prefix ...]^Show the HF DX Spotter Table
+Show the HF DX Spotter table for the list of prefixes for the last 
+<days> no of days (default is 31), starting from a <date> (default: today).
+
+If there are no prefixes then it will show the table for your country.
 
 Remember that some countries have more than one "DXCC country" in them
 (eg G :-), to show them (assuming you are not in G already which is
@@ -1833,6 +1902,27 @@ specially treated in the code) you must list all the relevant prefixes
 Note that the prefixes are converted into country codes so you don't have
 to list all possible prefixes for each country.
 
+If you want more or less days than the default simply include the
+number you require:-
+
+  sh/hftable 20 pa
+
+If you want to start at a different day, simply add the date in some 
+recognizable form:-
+
+  sh/hftable 2 25nov02
+  sh/hftable 2 25-nov-02 
+  sh/hftable 2 021125 
+  sh/hftable 2 25/11/02
+
+This will show the stats for your DXCC for that CQWW contest weekend. 
+
+You can specify either prefixes or full callsigns (so you can see how you
+did against all your mates). You can also say 'all' which will then print
+the worldwide statistics.
+
+  sh/hftable all 
+
 === 8^SHOW/HOPS <call> [ann|spots|route|wcy|wwv]^Show the hop counts for a node
 This command shows the hop counts set up for a node. You can specify
 which category you want to see. If you leave the category out then 
@@ -1985,8 +2075,8 @@ distance and bearing between two locators or (if only one locator is
 given on the command line) the distance and beraing from your station
 to the locator. For example:-
 
-SH/QRA IO92QL 
-SH/QRA JN06 IN73
+ SH/QRA IO92QL 
+ SH/QRA JN06 IN73
 
 The first example will show the distance and bearing to the locator from
 yourself, the second example will calculate the distance and bearing from
@@ -1996,20 +2086,22 @@ It is also possible to convert a latitude and longitude to a locator by
 using this command with a latitude and longitude as an argument, for
 example:-
 
-SH/QRA 52 41 N 0 58 E
+ SH/QRA 52 41 N 0 58 E
 
 === 0^SHOW/QRZ <callsign>^Show any callbook details on a callsign
 This command queries the QRZ callbook server on the internet
 and returns any information available for that callsign. This service
 is provided for users of this software by http://www.qrz.com 
 
+See also SHOW/WM7D for an alternative.
+
 === 9^SHOW/REGISTERED [<prefix>]^Show the registered users
 
 === 0^SHOW/ROUTE <callsign> ...^Show the route to the callsign
 This command allows you to see to which node the callsigns specified are
 connected. It is a sort of inverse sh/config.
 
-sh/route n2tly
+ sh/route n2tly
 
 === 0^SHOW/SATELLITE <name> [<hours> <interval>]^Show tracking data
 Show the tracking data from your location to the satellite of your choice
@@ -2029,8 +2121,8 @@ Each pass in a period is separated with a row of '-----' characters
 
 So for example:-
 
-SH/SAT AO-10 
-SH/SAT FENGYUN1 12 2
+ SH/SAT AO-10 
+ SH/SAT FENGYUN1 12 2
 
 === 6^SHOW/STATION ALL [<regex>]^Show list of users in the system
 === 0^SHOW/STATION [<callsign> ..]^Show information about a callsign
@@ -2084,12 +2176,15 @@ his is being run on this system, eg:-
 
   sh/usdb k1xx
 
-=== 0^SHOW/VHFSTATS^Show the VHF DX Statistics for last 31 days
-Show the VHF DX spots breakdown by band for the last 31 days
+=== 0^SHOW/VHFSTATS [days] [date]^Show the VHF DX Statistics
+Show the VHF DX spots breakdown by band for the last 
+<days> no of days (default is 31), starting from a date (default: today).
+
+=== 0^SHOW/VHFTABLE [days] [date] [prefix ...]^Show the VHF DX Spotter Table
+Show the VHF DX Spotter table for the list of prefixes for the last 
+<days> no of days (default is 31), starting from a date (default: today).
 
-=== 0^SHOW/VHFTABLE [prefix ...]^Show the VHF DX Spotter Table
-Show the VHF DX Spotter table for the list of prefixes for the last 31 days,
-if there are no prefixes then it will show the table for your country.
+If there are no prefixes then it will show the table for your country.
 
 Remember that some countries have more than one "DXCC country" in them
 (eg G :-), to show them (assuming you are not in G already which is
@@ -2100,9 +2195,37 @@ specially treated in the code) you must list all the relevant prefixes
 Note that the prefixes are converted into country codes so you don't have
 to list all possible prefixes for each country.
 
+If you want more or less days than the default simply include the
+number you require:-
+
+  sh/vhftable 20 pa
+
+If you want to start at a different day, simply add the date in some 
+recognizable form:-
+
+  sh/vhftable 2 25nov02
+  sh/vhftable 2 25-nov-02 
+  sh/vhftable 2 021125 
+  sh/vhftable 2 25/11/02
+
+This will show the stats for your DXCC for that CQWW contest weekend. 
+
+You can specify either prefixes or full callsigns (so you can see how you
+did against all your mates). You can also say 'all' which will then print
+the worldwide statistics.
+
+  sh/vhftable all 
+
 === 0^SHOW/WCY^Show last 10 WCY broadcasts
 === 0^SHOW/WCY <n>^Show last <n> WCY broadcasts
 Display the most recent WCY information that has been received by the system
+=== 0^SHOW/WM7D <callsign>^Show callbook details on a US callsigns
+This command queries the WM7D callbook server on the internet
+and returns any information available for that US callsign. This service
+is provided for users of this software by http://www.wm7d.net.
+
+See also SHOW/QRZ. 
 
 === 0^SHOW/WWV^Show last 10 WWV broadcasts
 === 0^SHOW/WWV <n>^Show last <n> WWV broadcasts