minor changes to the admin manual

diff --git a/html/adminmanual-1.html b/html/adminmanual-1.html
index b3881f67277a1d5df7c0afb67fd77b70a7ed635e..9bcb2d0602dff3ec16637c9dfb838ae7157ab78e 100644 (file)
--- a/html/adminmanual-1.html
+++ b/html/adminmanual-1.html
@@ -515,6 +515,24 @@ $def_hopcount = 5;
 series of PC frame types.  PC11 for example is a DX spot. The figures here 
 are not exhaustive but should give you a good idea of how the file works.
 <P>
 series of PC frame types.  PC11 for example is a DX spot. The figures here 
 are not exhaustive but should give you a good idea of how the file works.
 <P>

+<P>SHould any of the nodecalls include an ssid, it is important to wrap the
+whole call in single quotes, like this ...
+<P>
+<BLOCKQUOTE><CODE>
+<PRE>
+ 'DB0FHF-15' => {
+                        11 => 5,
+                        12 => 8,
+                        16 => 8,
+                        17 => 8,
+                        19 => 8,
+                        21 => 8,
+                   },
+</PRE>
+</CODE></BLOCKQUOTE>
+<P>If you do not do this, you will get errors and the file will not work as
+expected.
+<P>

 <P>You can alter this file at any time, including whilst the cluster is running.  
 If you alter the file during runtime, the command <EM>load/hops</EM> will 
 bring your changes into effect.
 <P>You can alter this file at any time, including whilst the cluster is running.  
 If you alter the file during runtime, the command <EM>load/hops</EM> will 
 bring your changes into effect.

diff --git a/sgml/adminmanual.sgml b/sgml/adminmanual.sgml
index 92831277ca7a166bca4f7817d120ea6a70af8279..16d03127a2347ad14c32f4475bc7606bbb7983de 100644 (file)
--- a/sgml/adminmanual.sgml
+++ b/sgml/adminmanual.sgml
@@ -514,6 +514,24 @@ Each set of hops is contained within a pair of curly braces and contains a
 series of PC frame types.  PC11 for example is a DX spot. The figures here 
 are not exhaustive but should give you a good idea of how the file works.
 
 series of PC frame types.  PC11 for example is a DX spot. The figures here 
 are not exhaustive but should give you a good idea of how the file works.
 

+<P>
+SHould any of the nodecalls include an ssid, it is important to wrap the
+whole call in single quotes, like this ...
+
+<tscreen><verb>
+ 'DB0FHF-15' => {
+                        11 => 5,
+                        12 => 8,
+                        16 => 8,
+                        17 => 8,
+                        19 => 8,
+                        21 => 8,
+                   },
+</verb></tscreen>
+
+If you do not do this, you will get errors and the file will not work as
+expected.
+

 <P>
 You can alter this file at any time, including whilst the cluster is running.  
 If you alter the file during runtime, the command <em>load/hops</em> will 
 <P>
 You can alter this file at any time, including whilst the cluster is running.  
 If you alter the file during runtime, the command <em>load/hops</em> will 

diff --git a/txt/adminmanual.txt b/txt/adminmanual.txt
index ba88f983dde6d795e6bbece5e23e118e2531386a..d0136c57f1823fcbd1273f4a8a2aacbf62ff232a 100644 (file)
--- a/txt/adminmanual.txt
+++ b/txt/adminmanual.txt
@@ -916,12 +916,33 @@
   how the file works.
 
 
   how the file works.
 
 

+  SHould any of the nodecalls include an ssid, it is important to wrap
+  the whole call in single quotes, like this ...
+
+
+
+
+   'DB0FHF-15' => {
+                          11 => 5,
+                          12 => 8,
+                          16 => 8,
+                          17 => 8,
+                          19 => 8,
+                          21 => 8,
+                     },
+
+
+
+
+  If you do not do this, you will get errors and the file will not work
+  as expected.
+
+

   You can alter this file at any time, including whilst the cluster is
   running.  If you alter the file during runtime, the command load/hops
   will bring your changes into effect.
 
 
   You can alter this file at any time, including whilst the cluster is
   running.  If you alter the file during runtime, the command load/hops
   will bring your changes into effect.
 
 

-

   1.11.  Hop Control on Specific Nodes
 
   You can set a callsign specific hop count for any of the standard
   1.11.  Hop Control on Specific Nodes
 
   You can set a callsign specific hop count for any of the standard


@@ -984,38 +1005,34 @@
 
 
 
 
 
 

+       # the list of regexes for messages that we won't store having
+       # received them (bear in mind that we must receive them fully before
+       # we can bin them)

 
 
 
 

+       # The format of each line is as follows

 
 

+       #     type      source             pattern
+       #     P/B/F     T/F/O/S            regex

 
 

-  # the list of regexes for messages that we won't store having
-  # received them (bear in mind that we must receive them fully before
-  # we can bin them)
-
-
-  # The format of each line is as follows
-
-  #     type      source             pattern
-  #     P/B/F     T/F/O/S            regex
-
-  # type: P - private, B - bulletin (msg), F - file (ak1a bull)
-  # source: T - to field, F - from field,  O - origin, S - subject
-  # pattern: a perl regex on the field requested
+       # type: P - private, B - bulletin (msg), F - file (ak1a bull)
+       # source: T - to field, F - from field,  O - origin, S - subject
+       # pattern: a perl regex on the field requested

 
 

-  # Currently only type B and P msgs are affected by this code.
-  #
-  # The list is read from the top down, the first pattern that matches
-  # causes the action to be taken.
+       # Currently only type B and P msgs are affected by this code.
+       #
+       # The list is read from the top down, the first pattern that matches
+       # causes the action to be taken.

 
 

-  # The pattern can be undef or 0 in which case it will always be selected
-  # for the action specified
+       # The pattern can be undef or 0 in which case it will always be selected
+       # for the action specified

 
 
 
 
 
 

-  package DXMsg;
+       package DXMsg;

 
 

-  @badmsg = (
-  );
+       @badmsg = (
+       );

 
 
 
 
 
 


@@ -1100,6 +1117,9 @@
   of show/baddx, show/badspotter and show/badnode.
 
 
   of show/baddx, show/badspotter and show/badnode.
 
 

+
+
+

   3.  Mail
 
   DXSpider deals seamlessly with standard AK1A type mail.  It supports
   3.  Mail
 
   DXSpider deals seamlessly with standard AK1A type mail.  It supports


@@ -1120,6 +1140,8 @@
   default method of sending mail and so a simple s for send will do.  A
   full list of the send commands and options is in the command set
   section, so I will not duplicate them here.
   default method of sending mail and so a simple s for send will do.  A
   full list of the send commands and options is in the command set
   section, so I will not duplicate them here.

+
+

   3.2.  Bulletin mail
 
   Bulletin mail is sent by using the sb command.  This is one of the
   3.2.  Bulletin mail
 
   Bulletin mail is sent by using the sb command.  This is one of the


@@ -1147,41 +1169,58 @@
 
 
 
 
 
 

-       #
-       # this is an example message forwarding file for the system
-       #
-       # The format of each line is as follows
-       #
-       #     type    to/from/at pattern action  destinations
-       #     P/B/F     T/F/A     regex   I/F    [ call [, call ...] ]
-       #
-       # type: P - private, B - bulletin (msg), F - file (ak1a bull)
-       # to/from/at: T - to field, F - from field, A - home bbs, O - origin
-       # pattern: a perl regex on the field requested
-       # action: I - ignore, F - forward
-       # destinations: a reference to an array containing node callsigns
-       #
-       # if it is non-private and isn't in here then it won't get forwarded
-       #
-       # Currently only type B msgs are affected by this code.
-       #
-       # The list is read from the top down, the first pattern that matches
-       # causes the action to be taken.
-       #
-       # The pattern can be undef or 0 in which case it will always be selected
-       # for the action specified
-       #
-       # If the BBS list is undef or 0 and the action is 'F' (and it matches the
-       # pattern) then it will always be forwarded to every node that doesn't have
-       # it (I strongly recommend you don't use this unless you REALLY mean it, if
-       # you allow a new link with this on EVERY bull will be forwarded immediately
-       # on first connection)
-       #

 
 

-       package DXMsg;

 
 

-       @forward = (
-       );
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+  #
+  # this is an example message forwarding file for the system
+  #
+  # The format of each line is as follows
+  #
+  #     type    to/from/at pattern action  destinations
+  #     P/B/F     T/F/A     regex   I/F    [ call [, call ...] ]
+  #
+  # type: P - private, B - bulletin (msg), F - file (ak1a bull)
+  # to/from/at: T - to field, F - from field, A - home bbs, O - origin
+  # pattern: a perl regex on the field requested
+  # action: I - ignore, F - forward
+  # destinations: a reference to an array containing node callsigns
+  #
+  # if it is non-private and isn't in here then it won't get forwarded
+  #
+  # Currently only type B msgs are affected by this code.
+  #
+  # The list is read from the top down, the first pattern that matches
+  # causes the action to be taken.
+  #
+  # The pattern can be undef or 0 in which case it will always be selected
+  # for the action specified
+  #
+  # If the BBS list is undef or 0 and the action is 'F' (and it matches the
+  # pattern) then it will always be forwarded to every node that doesn't have
+  # it (I strongly recommend you don't use this unless you REALLY mean it, if
+  # you allow a new link with this on EVERY bull will be forwarded immediately
+  # on first connection)
+  #
+
+  package DXMsg;
+
+  @forward = (
+  );

 
 
 
 
 
 


@@ -1205,20 +1244,28 @@
 
 
 
 
 
 

-         MSG TO <msgno> <call>     - change TO callsign to <call>
-         MSG FRom <msgno> <call>   - change FROM callsign to <call>
-         MSG PRrivate <msgno>      - set private flag
-         MSG NOPRrivate <msgno>    - unset private flag
-         MSG RR <msgno>            - set RR flag
-         MSG NORR <msgno>          - unset RR flag
-         MSG KEep <msgno>          - set the keep flag (message won't be deleted ever)
-         MSG NOKEep <msgno>        - unset the keep flag
-         MSG SUbject <msgno> <new> - change the subject to <new>
-         MSG WAittime <msgno>      - remove any waiting time for this message
-         MSG NOREad <msgno>        - mark message as unread
-         MSG REad <msgno>          - mark message as read
-         MSG QUeue                 - queue any outstanding bulletins
-         MSG QUeue 1               - queue any outstanding private messages
+
+
+
+
+
+
+
+
+    MSG TO <msgno> <call>     - change TO callsign to <call>
+    MSG FRom <msgno> <call>   - change FROM callsign to <call>
+    MSG PRrivate <msgno>      - set private flag
+    MSG NOPRrivate <msgno>    - unset private flag
+    MSG RR <msgno>            - set RR flag
+    MSG NORR <msgno>          - unset RR flag
+    MSG KEep <msgno>          - set the keep flag (message won't be deleted ever)
+    MSG NOKEep <msgno>        - unset the keep flag
+    MSG SUbject <msgno> <new> - change the subject to <new>
+    MSG WAittime <msgno>      - remove any waiting time for this message
+    MSG NOREad <msgno>        - mark message as unread
+    MSG REad <msgno>          - mark message as read
+    MSG QUeue                 - queue any outstanding bulletins
+    MSG QUeue 1               - queue any outstanding private messages

 
 
 
 
 
 


@@ -1252,6 +1299,10 @@
          Times read: 0
        G0VGS de GB7MBC 28-Jan-2001 1308Z >
 
          Times read: 0
        G0VGS de GB7MBC 28-Jan-2001 1308Z >
 

+
+
+
+

   3.6.  Filtering mail
 
   This is described in the section on Other filters so I will not
   3.6.  Filtering mail
 
   This is described in the section on Other filters so I will not


@@ -1267,7 +1318,6 @@
   SYSOP.pl that caters for the UK sysops.
 
 
   SYSOP.pl that caters for the UK sysops.
 
 

-

        qw(GB7TLH GB7DJK GB7DXM GB7CDX GB7BPQ GB7DXN GB7MBC GB7MBC-6 GB7MDX
           GB7NDX GB7SDX GB7TDX GB7UDX GB7YDX GB7ADX GB7BAA GB7DXA GB7DXH
           GB7DXK GB7DXI GB7DXS)
        qw(GB7TLH GB7DJK GB7DXM GB7CDX GB7BPQ GB7DXN GB7MBC GB7MBC-6 GB7MDX
           GB7NDX GB7SDX GB7TDX GB7UDX GB7YDX GB7ADX GB7BAA GB7DXA GB7DXH
           GB7DXK GB7DXI GB7DXS)


@@ -1310,26 +1360,18 @@
 
 
 
 
 
 

-
-
-
-
-
-
-
-
-  #
-  # startup script example
-  #
-  # set maximum no of spots allowed to 100
-  # set/var $Spot::maxspots = 1
-  #
-  # Set registration on
-  # set/var $main::reqreg = 1
-  #
-  # Set passwords on
-  # set/var $main::passwdreq = 1
-  #
+       #
+       # startup script example
+       #
+       # set maximum no of spots allowed to 100
+       # set/var $Spot::maxspots = 1
+       #
+       # Set registration on
+       # set/var $main::reqreg = 1
+       #
+       # Set passwords on
+       # set/var $main::passwdreq = 1
+       #

 
 
 
 
 
 


@@ -1342,8 +1384,6 @@
   eventually users will be able to set their own.  An example is
   included in the distibution but here is a further example.
 
   eventually users will be able to set their own.  An example is
   included in the distibution but here is a further example.
 

-
-

        #
        # G0FYD
        #
        #
        # G0FYD
        #


@@ -1450,6 +1490,7 @@
 
 
 
 
 
 

+

   This will update the existing local oblast database or create it if it
   does not exist.
 
   This will update the existing local oblast database or create it if it
   does not exist.
 


@@ -1473,6 +1514,8 @@
 
 
 
 
 
 

+
+

   5.4.  Looking up databases
 
   To look for information in a defined database, simply use the dbshow
   5.4.  Looking up databases
 
   To look for information in a defined database, simply use the dbshow


@@ -1516,6 +1559,7 @@
   If you remove a database it ceases to exist and would have to be
   created from scratch if you still required it.
 
   If you remove a database it ceases to exist and would have to be
   created from scratch if you still required it.
 

+

   6.  Information, files and useful programs
 
   6.1.  MOTD
   6.  Information, files and useful programs
 
   6.1.  MOTD


@@ -1536,6 +1580,8 @@
   registered they will receive the same message as any other user.
 
 
   registered they will receive the same message as any other user.
 
 

+
+

   6.3.  Downtime message
 
   If for any reason the cluster is down, maybe for upgrade or
   6.3.  Downtime message
 
   If for any reason the cluster is down, maybe for upgrade or


@@ -1602,7 +1648,6 @@
 
 
 
 
 
 

-

   You can see that in the files area (basically the packclus directory)
   there is a file called news and a directory called bulletin.  You can
   also see that dates they were created.  In the case of the file news,
   You can see that in the files area (basically the packclus directory)
   there is a file called news and a directory called bulletin.  You can
   also see that dates they were created.  In the case of the file news,


@@ -1645,22 +1690,19 @@
 
 
 
 
 
 

-
-
-
-  type bulletin/opdx391
-  Ohio/Penn DX Bulletin No. 391
-  The Ohio/Penn Dx PacketCluster
-  DX Bulletin No. 391
-  BID: $OPDX.391
-  January 11, 1999
-  Editor Tedd Mirgliotta, KB8NW
-  Provided by BARF-80 BBS Cleveland, Ohio
-  Online at 440-237-8208 28.8k-1200 Baud 8/N/1 (New Area Code!)
-  Thanks to the Northern Ohio Amateur Radio Society, Northern Ohio DX
-  Association, Ohio/Penn PacketCluster Network, K1XN & Golist, WB2RAJ/WB2YQH
-  & The 59(9) DXReport, W3UR & The Daily DX, K3TEJ, KN4UG, W4DC, NC6J, N6HR,
-  Press Enter to continue, A to abort (508 lines) >
+       type bulletin/opdx391
+       Ohio/Penn DX Bulletin No. 391
+       The Ohio/Penn Dx PacketCluster
+       DX Bulletin No. 391
+       BID: $OPDX.391
+       January 11, 1999
+       Editor Tedd Mirgliotta, KB8NW
+       Provided by BARF-80 BBS Cleveland, Ohio
+       Online at 440-237-8208 28.8k-1200 Baud 8/N/1 (New Area Code!)
+       Thanks to the Northern Ohio Amateur Radio Society, Northern Ohio DX
+       Association, Ohio/Penn PacketCluster Network, K1XN & Golist, WB2RAJ/WB2YQH
+       & The 59(9) DXReport, W3UR & The Daily DX, K3TEJ, KN4UG, W4DC, NC6J, N6HR,
+       Press Enter to continue, A to abort (508 lines) >

 
 
 
 
 
 


@@ -1693,6 +1735,30 @@
 
 
 
 
 
 

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+