added set/hops and show/hops commands
[spider.git] / cmd / Commands_en.hlp
index 971765143762bae70c641a083b8f242e3b0aea51..92389a364459afa8f92d6b7eb709ccfd44cdc173 100644 (file)
@@ -41,10 +41,12 @@ some examples:-
 or
   acc/ann by G,M,2 
 
-You can use the tag 'all' to reject everything that is left, eg:
+You can use the tag 'all' to accept everything eg:
 
   acc/ann all
 
+but this probably for advanced users...
+
 === 8^ACCEPT/ANNOUNCE <call> [input] [0-9] <pattern>^Announce filter sysop version
 This version allows a sysop to set a filter for a callsign as well as the
 default for nodes and users eg:-
@@ -75,15 +77,23 @@ You can use any of the following things in this line:-
   origin <prefixes>
   channel <prefixes>
 
+For frequencies, you can use any of the band names defined in
+SHOW/BANDS and you can use a subband name like: cw, rtty, data, ssb -
+thus: hf/ssb. You can also just have a simple range like: 0/30000 -
+this is more efficient than saying simply: freq HF (but don't get
+too hung up about that)
+
 some examples:-
 
   acc/spot 1 freq hf/cw
   acc/spot 2 freq vhf and (by_zone 14,15,16 or call_zone 14,15,16)
 
-You can use the tag 'all' to reject everything that is left, eg:
+You can use the tag 'all' to accept everything, eg:
 
   ann/spot 3 all
 
+but this probably for advanced users...
+
 === 8^ACCEPT/SPOTS <call> [input] [0-9] <pattern>^Spot filter sysop version
 This version allows a sysop to set a filter for a callsign as well as the
 default for nodes and users eg:-
@@ -448,6 +458,27 @@ To remove the filter in its entirty:-
 
   clear/spots all
 
+ADVANCED USERS:-
+
+Once you are happy with the results you get, you may like to experiment. 
+
+my example that filters hf/cw spots and accepts vhf/uhf spots from EU can be 
+written with a mixed filter, eg:
+
+  rej/spot freq hf/cw
+  acc/spot freq 0/30000
+  acc/spot 2 freq 50000/1400000 and (by_zone 14,15,16 or call_zone 14,15,16)
+
+each filter slot actually has a 'reject' slot and an 'accept' slot. The reject
+slot is executed BEFORE the accept slot.
+
+It was mentioned earlier that after a reject test that doesn't match, the default
+for following tests is 'accept', the reverse is true for 'accept'. In the example
+what happens is that the reject is executed first, any non hf/cw spot is passed 
+to the accept line, which lets thru everything else on HF.
+
+The next filter line lets through just VHF/UHF spots from EU.
+
 === 1^FORWARD/OPERNAM <call>^Send out information on this <call> to all clusters
 This command sends out any information held in the user file which can 
 be broadcast in PC41 protocol packets. This information is Name, QTH, Location
@@ -662,10 +693,12 @@ some examples:-
 
   rej/ann by_zone 14,15,16 and not by G,M,2
  
-You can use the tag 'all' to reject everything that is left, eg:
+You can use the tag 'all' to reject everything eg:
 
   rej/ann all
 
+but this probably for advanced users...
+
 === 8^REJECT/ANNOUNCE <call> [input] [0-9] <pattern>^Announce filter sysop version
 This version allows a sysop to set a filter for a callsign as well as the
 default for nodes and users eg:-
@@ -696,15 +729,23 @@ You can use any of the following things in this line:-
   origin <prefixes>
   channel <prefixes>
 
+For frequencies, you can use any of the band names defined in
+SHOW/BANDS and you can use a subband name like: cw, rtty, data, ssb -
+thus: hf/ssb. You can also just have a simple range like: 0/30000 -
+this is more efficient than saying simply: freq HF (but don't get
+too hung up about that)
+
 some examples:-
 
   rej/spot 1 freq hf
   rej/spot 2 freq vhf and not (by_zone 14,15,16 or call_zone 14,15,16)
 
-You can use the tag 'all' to reject everything that is left, eg:
+You can use the tag 'all' to reject everything eg:
 
   rej/spot 3 all
 
+but this probably for advanced users...
+
 === 8^REJECT/SPOTS <call> [input] [0-9] <pattern>^Spot filter sysop version
 This version allows a sysop to set a filter for a callsign as well as the
 default for nodes and users eg:-
@@ -799,6 +840,19 @@ to you will normally find their way there should you not be connected.
 eg:-
   SET/HOMENODE gb7djk
 
+=== 8^SET/HOPS <call> ann|spots|wwv|wcy <n>^Set hop count  
+Set the hop count for a particular type of broadcast for a node.
+
+This command allows you to set up special hop counts for a node 
+for currently: announce, spots, wwv and wcy broadcasts.
+
+eg:
+  set/hops gb7djk ann 10
+  set/hops gb7mbc spots 20
+
+Set SHOW/HOPS for information on what is already set. This command
+creates a filter and works in conjunction with the filter system. 
+
 === 9^SET/ISOLATE^Isolate a node from the rest of the network
 Connect a node to your system in such a way that you are a full protocol
 member of its network and can see all spots on it, but nothing either leaks
@@ -1006,6 +1060,11 @@ 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.
 
+=== 8^SHOW/HOPS <call> [ann|spots|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 
+all the categories will be listed.
 === 1^SHOW/ISOLATE^Show list of ISOLATED nodes
 
 === 9^SHOW/LOCKOUT^Show the list of locked out or excluded callsigns