tidied up the filtering help a bit
authorminima <minima>
Sat, 4 Nov 2000 02:06:40 +0000 (02:06 +0000)
committerminima <minima>
Sat, 4 Nov 2000 02:06:40 +0000 (02:06 +0000)
cmd/Commands_en.hlp

index 92389a364459afa8f92d6b7eb709ccfd44cdc173..bcc5196f091a2be1e9d97d7040828828f125a791 100644 (file)
@@ -362,18 +362,19 @@ made on the filename (if any) that you specify.
 There are a number of things you can filter in the DXSpider system. They
 all use the same general mechanism.
 
-In general terms you can create a 'reject' or an 'accept' filter which can
-have up to 10 lines in it. You do this using, for example:-
+In general terms you can create a 'reject' or an 'accept' filter which
+can have up to 10 lines in it. You do this using, for example:-
  
   accept/spots .....
   reject/spots .....
 
-where ..... are the specific commands for that type of filter. There are 
-filters for spots, wwv, announce, wcy and (for sysops) connects. See each
-different accept or reject command reference for more details.
+where ..... are the specific commands for that type of filter. There
+are filters for spots, wwv, announce, wcy and (for sysops)
+connects. See each different accept or reject command reference for
+more details.
 
-There is also a command to clear out one or more lines in a filter and one
-to show you what you have set. They are:-
+There is also a command to clear out one or more lines in a filter and
+one to show you what you have set. They are:-
 
   clear/spots 1
   clear/spots all
@@ -384,25 +385,26 @@ and
 
 There is clear/xxxx command for each type of filter.
 
-For now we are going to use spots for the examples, but you can apply the 
-principles to all types of filter. 
+For now we are going to use spots for the examples, but you can apply
+the principles to all types of filter.
 
-There are two main types of filter 'accept' or 'reject'; which you use depends
-entirely on how you look at the world and what is least writing to achieve 
-what you want. Each filter has 10 lines (of any length) which are tried in 
-order. If a line matches then the action you have specified is taken (ie reject
-means ignore it and accept means gimme it).
+There are two main types of filter 'accept' or 'reject'; which you use
+depends entirely on how you look at the world and what is least
+writing to achieve what you want. Each filter has 10 lines (of any
+length) which are tried in order. If a line matches then the action
+you have specified is taken (ie reject means ignore it and accept
+means gimme it).
 
-The important thing to remember is that if you specify a 'reject' filter (all
-the lines in it say 'reject/spots' (for instance) then if a spot comes in that
-doesn't match any of the lines then you will get it BUT if you specify an
-'accept' filter then any spots that don't match are dumped. For example if I 
-have a one line accept filter:-
+The important thing to remember is that if you specify a 'reject'
+filter (all the lines in it say 'reject/spots' (for instance) then if
+a spot comes in that doesn't match any of the lines then you will get
+it BUT if you specify an 'accept' filter then any spots that don't
+match are dumped. For example if I have a one line accept filter:-
 
   accept/spots freq vhf and (by_zone 14,15,16 or call_zone 14,15,16)
 
-then automatically you will ONLY get VHF spots from or to CQ zones 14 15 and 16.
-If you set a reject filter like:
+then automatically you will ONLY get VHF spots from or to CQ zones 14
+15 and 16.  If you set a reject filter like:
 
   reject/spots freq hf/cw
 
@@ -415,35 +417,38 @@ But in that case you might only be interested in iota and say:-
 
   accept/spots not freq hf/cw or info iota
 
-which is exactly the same. You should choose one or the other until you are
-confortable with the way it works. Yes, you can mix them (actually you can
-have an accept AND a reject on the same line) but don't try this at home
-until you can analyse the results that you get without ringing up the sysop
-for help.
+which is exactly the same. You should choose one or the other until
+you are confortable with the way it works. Yes, you can mix them
+(actually you can have an accept AND a reject on the same line) but
+don't try this at home until you can analyse the results that you get
+without ringing up the sysop for help.
 
-You can arrange your filter lines into logical units, either for your own 
-understanding or simply convenience. I have one set frequently:-
+You can arrange your filter lines into logical units, either for your
+own understanding or simply convenience. I have one set frequently:-
 
   reject/spots 1 freq/cw
   reject/spots 2 freq 50000/1400000 not (by_zone 14,15,16 or call_zone 14,15,16)  
 
-What this does is to ignore all HF CW spots (being a class B I can't read
-any CW and couldn't possibly be interested in HF :-) and also rejects any
-spots on VHF which don't either originate or spot someone in Europe.
+What this does is to ignore all HF CW spots (being a class B I can't
+read any CW and couldn't possibly be interested in HF :-) and also
+rejects any spots on VHF which don't either originate or spot someone
+in Europe.
 
-This is an exmaple where you would use the line number (1 and 2 in this case),
-if you leave the digit out, the system assumes '1'. Digits '0'-'9' are 
-available.
+This is an exmaple where you would use the line number (1 and 2 in
+this case), if you leave the digit out, the system assumes '1'. Digits
+'0'-'9' are available.
 
-You can leave the word 'and' out if you want, it is implied. You can use any 
-number of brackets to make the 'expression' as you want it. There are things
-called precedence rules working here which mean that you will NEED brackets 
-in a situation like line 2 because, without it, will assume:-
+You can leave the word 'and' out if you want, it is implied. You can
+use any number of brackets to make the 'expression' as you want
+it. There are things called precedence rules working here which mean
+that you will NEED brackets in a situation like line 2 because,
+without it, will assume:-
 
   (freq 50000/1400000 and by_zone 14,15,16) or call_zone 14,15,16 
 
-annoying, but that is the way it is. If you use OR - use brackets. Whilst we
-are here CASE is not important. 'And BY_Zone' is just 'and by_zone'.
+annoying, but that is the way it is. If you use OR - use
+brackets. Whilst we are here CASE is not important. 'And BY_Zone' is
+just 'and by_zone'.
 
 If you want to alter your filter you can just redefine one or more
 lines of it or clear out one line. For example:-
@@ -462,20 +467,21 @@ 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:
+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.
+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.
+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.