From 8b3403b35f575d43a6c8b316ad4b5c6dd5289752 Mon Sep 17 00:00:00 2001
From: minima <minima>
Date: Thu, 1 Jan 2004 15:42:28 +0000
Subject: [PATCH] made some detail changes to the installation manual

---
 Changes                     |  1 +
 html/installation_en-1.html | 46 +++++++++++++++-----------
 sgml/installation_en.sgml   | 46 +++++++++++++++-----------
 txt/installation_en.txt     | 65 ++++++++++++++++++++++---------------
 4 files changed, 93 insertions(+), 65 deletions(-)

diff --git a/Changes b/Changes
index 8807fb5f..b307562c 100644
--- a/Changes
+++ b/Changes
@@ -1,6 +1,7 @@
 01Jan04=======================================================================
 1. move position of USDB init to get rid of an obscure bug pointed out by
 Charlie K1XX.
+2. Remove redundant documentation
 31Dec03=======================================================================
 1. alter remote database handling to 'new standard'.
 30Dec03=======================================================================
diff --git a/html/installation_en-1.html b/html/installation_en-1.html
index 72c3a30f..7108902f 100644
--- a/html/installation_en-1.html
+++ b/html/installation_en-1.html
@@ -28,7 +28,7 @@ know how to use <EM>tar</EM> and how to edit files using your favourite editor.<
 <P>The crucial ingredient for all of this is 
 <A HREF="http://www.perl.org">Perl</A>.  Earlier versions of
 Spider required perl 5.004, however it is now <I>STRONGLY</I> recommended
-that you use at least version 5.005_03 as this is the version being used
+that you use at least version 5.6.1 as this is the version being used
 in the development of Spider.</P>
 
 <P>In addition to the standard Red Hat distribution you will require the 
@@ -41,11 +41,11 @@ perl distribution.</P>
 <P>
 <UL>
 <LI> 
-<A HREF="http://www.cpan.org/modules/by-module/Data/Data-Dumper-2.10.tar.gz">Data-Dumper-2.101.tar.gz</A></LI>
+<A HREF="http://www.cpan.org/modules/by-module/Data/Data-Dumper-2.101.tar.gz">Data-Dumper-2.101.tar.gz</A>  <EM> this is included in perl 5.6.1 and above </EM></LI>
 <LI> 
 <A HREF="http://www.cpan.org/modules/by-module/Date/TimeDate-1.10.tar.gz">TimeDate-1.10.tar.gz</A></LI>
 <LI> 
-<A HREF="http://www.cpan.org/modules/by-module/IO/IO-1.20.tar.gz">IO-1.20.tar.gz (for perl 5.00403 and lower)</A></LI>
+<A HREF="http://www.cpan.org/modules/by-module/IO/IO-1.20.tar.gz">IO-1.20.tar.gz</A>  (<EM>for perl 5.00403 and lower</EM>)</LI>
 <LI> 
 <A HREF="http://www.cpan.org/modules/by-module/Net/Net-Telnet-3.03.tar.gz">Net-Telnet-3.03.tar.gz</A></LI>
 <LI> 
@@ -64,13 +64,6 @@ that's where you have put them.</P>
 <P>Log in as 'root', and make sure you're at '/root' before you continue. Here are exactly the commands you must issue next: -</P>
 <P>
 <PRE>
-# tar xvfz /usr/local/packages/Data-Dumper-2.101.tar.gz
-# cd Data-Dumper-2.101
-# perl Makefile.PL
-# make test
-# make install
-# cd ..
-#
 # tar xvfz /usr/local/packages/TimeDate-1.10.tar.gz
 # cd TimeDate-1.10
 # perl Makefile.PL
@@ -78,13 +71,6 @@ that's where you have put them.</P>
 # make install
 # cd ..
 #
-# tar xvfz /usr/local/packages/IO-1.20.tar.gz
-# cd IO-1.20
-# perl Makefile.PL
-# make test
-# make install UNINST=1
-# cd ..
-#
 # tar xvfz /usr/local/packages/Net-Telnet-3.03.tar.gz
 # cd Net-Telnet-3.02
 # perl Makefile.PL
@@ -115,6 +101,27 @@ that's where you have put them.</P>
 </PRE>
 </P>
 
+<P>Only if you need to do these (because your perl is old):-</P>
+<P>
+<PRE>
+#
+# tar xvfz /usr/local/packages/IO-1.20.tar.gz
+# cd IO-1.20
+# perl Makefile.PL
+# make test
+# make install UNINST=1
+# cd ..
+#
+# tar xvfz /usr/local/packages/Data-Dumper-2.101.tar.gz
+# cd Data-Dumper-2.101
+# perl Makefile.PL
+# make test
+# make install
+# cd ..
+#
+</PRE>
+</P>
+
 <P>Do not fall into the trap of thinking they're all the same, just because they 
 nearly are! Pay particular attention to the instructions of <EM>IO</EM>, above.</P>
 
@@ -246,8 +253,9 @@ $mycall = "GB7DJK";
 </CODE></BLOCKQUOTE>
 </P>
 
-<P>This is the call sign of your cluster.  If you use an SSID then include it here
-also.</P>
+<P>This is the call sign of your cluster.  Here in the UK we have 
+separate callsigns for our cluster nodes. If you can't use a different callsign I suggest
+you use an SSID of '-2' for the node callsign '$mycall'.</P>
 <P>
 <BLOCKQUOTE><CODE>
 <PRE>
diff --git a/sgml/installation_en.sgml b/sgml/installation_en.sgml
index de183687..5e8c3b6d 100644
--- a/sgml/installation_en.sgml
+++ b/sgml/installation_en.sgml
@@ -36,7 +36,7 @@ know how to use <em>tar</em> and how to edit files using your favourite editor.
 The crucial ingredient for all of this is 
 <htmlurl url="http://www.perl.org" name="Perl">.  Earlier versions of
 Spider required perl 5.004, however it is now <it>STRONGLY</it> recommended
-that you use at least version 5.005_03 as this is the version being used
+that you use at least version 5.6.1 as this is the version being used
 in the development of Spider.
 
 <P>
@@ -48,9 +48,9 @@ perl distribution.
 
 <P>
 <itemize>
-<item> <htmlurl url="http://www.cpan.org/modules/by-module/Data/Data-Dumper-2.10.tar.gz" name="Data-Dumper-2.101.tar.gz">
+<item> <htmlurl url="http://www.cpan.org/modules/by-module/Data/Data-Dumper-2.101.tar.gz" name="Data-Dumper-2.101.tar.gz">  <em> this is included in perl 5.6.1 and above </em>
 <item> <htmlurl url="http://www.cpan.org/modules/by-module/Date/TimeDate-1.10.tar.gz" name="TimeDate-1.10.tar.gz">
-<item> <htmlurl url="http://www.cpan.org/modules/by-module/IO/IO-1.20.tar.gz" name="IO-1.20.tar.gz (for perl 5.00403 and lower)">
+<item> <htmlurl url="http://www.cpan.org/modules/by-module/IO/IO-1.20.tar.gz" name="IO-1.20.tar.gz">  (<em>for perl 5.00403 and lower</em>)
 <item> <htmlurl url="http://www.cpan.org/modules/by-module/Net/Net-Telnet-3.03.tar.gz" name="Net-Telnet-3.03.tar.gz">
 <item> <htmlurl url="http://www.cpan.org/modules/by-module/Curses/Curses-1.06.tar.gz" name="Curses-1.06.tar.gz">
 <item> <htmlurl url="http://www.cpan.org/modules/by-module/Time/Time-HiRes-01.20.tar.gz" name="Time-HiRes-01.20.tar.gz">
@@ -66,13 +66,6 @@ that's where you have put them.
 Log in as 'root', and make sure you're at '/root' before you continue. Here are exactly the commands you must issue next: -
 
 <verb>
-# tar xvfz /usr/local/packages/Data-Dumper-2.101.tar.gz
-# cd Data-Dumper-2.101
-# perl Makefile.PL
-# make test
-# make install
-# cd ..
-#
 # tar xvfz /usr/local/packages/TimeDate-1.10.tar.gz
 # cd TimeDate-1.10
 # perl Makefile.PL
@@ -80,13 +73,6 @@ Log in as 'root', and make sure you're at '/root' before you continue. Here are
 # make install
 # cd ..
 #
-# tar xvfz /usr/local/packages/IO-1.20.tar.gz
-# cd IO-1.20
-# perl Makefile.PL
-# make test
-# make install UNINST=1
-# cd ..
-#
 # tar xvfz /usr/local/packages/Net-Telnet-3.03.tar.gz
 # cd Net-Telnet-3.02
 # perl Makefile.PL
@@ -116,6 +102,27 @@ Log in as 'root', and make sure you're at '/root' before you continue. Here are
 # cd ..
 </verb>
 
+<p>
+Only if you need to do these (because your perl is old):-
+
+<verb>
+#
+# tar xvfz /usr/local/packages/IO-1.20.tar.gz
+# cd IO-1.20
+# perl Makefile.PL
+# make test
+# make install UNINST=1
+# cd ..
+#
+# tar xvfz /usr/local/packages/Data-Dumper-2.101.tar.gz
+# cd Data-Dumper-2.101
+# perl Makefile.PL
+# make test
+# make install
+# cd ..
+#
+</verb>
+
 <P>
 Do not fall into the trap of thinking they're all the same, just because they 
 nearly are! Pay particular attention to the instructions of <em>IO</em>, above.
@@ -234,8 +241,9 @@ $mycall = "GB7DJK";
 </verb></tscreen>
 
 <P>
-This is the call sign of your cluster.  If you use an SSID then include it here
-also.
+This is the call sign of your cluster.  Here in the UK we have 
+separate callsigns for our cluster nodes. If you can't use a different callsign I suggest
+you use an SSID of '-2' for the node callsign '$mycall'.
 
 <tscreen><verb>
 $myalias = "G1TLH";
diff --git a/txt/installation_en.txt b/txt/installation_en.txt
index c552afab..ac606c76 100644
--- a/txt/installation_en.txt
+++ b/txt/installation_en.txt
@@ -80,8 +80,8 @@
 
   The crucial ingredient for all of this is Perl.  Earlier versions of
   Spider required perl 5.004, however it is now STRONGLY recommended
-  that you use at least version 5.005_03 as this is the version being
-  used in the development of Spider.
+  that you use at least version 5.6.1 as this is the version being used
+  in the development of Spider.
 
 
   In addition to the standard Red Hat distribution you will require the
@@ -93,11 +93,11 @@
 
 
 
-  o  Data-Dumper-2.101.tar.gz
+  o  Data-Dumper-2.101.tar.gz   this is included in perl 5.6.1 and above
 
   o  TimeDate-1.10.tar.gz
 
-  o  IO-1.20.tar.gz (for perl 5.00403 and lower)
+  o  IO-1.20.tar.gz  (for perl 5.00403 and lower)
 
   o  Net-Telnet-3.03.tar.gz
 
@@ -119,13 +119,6 @@
 
 
 
-  # tar xvfz /usr/local/packages/Data-Dumper-2.101.tar.gz
-  # cd Data-Dumper-2.101
-  # perl Makefile.PL
-  # make test
-  # make install
-  # cd ..
-  #
   # tar xvfz /usr/local/packages/TimeDate-1.10.tar.gz
   # cd TimeDate-1.10
   # perl Makefile.PL
@@ -133,13 +126,6 @@
   # make install
   # cd ..
   #
-  # tar xvfz /usr/local/packages/IO-1.20.tar.gz
-  # cd IO-1.20
-  # perl Makefile.PL
-  # make test
-  # make install UNINST=1
-  # cd ..
-  #
   # tar xvfz /usr/local/packages/Net-Telnet-3.03.tar.gz
   # cd Net-Telnet-3.02
   # perl Makefile.PL
@@ -170,6 +156,27 @@
 
 
 
+  Only if you need to do these (because your perl is old):-
+
+
+  #
+  # tar xvfz /usr/local/packages/IO-1.20.tar.gz
+  # cd IO-1.20
+  # perl Makefile.PL
+  # make test
+  # make install UNINST=1
+  # cd ..
+  #
+  # tar xvfz /usr/local/packages/Data-Dumper-2.101.tar.gz
+  # cd Data-Dumper-2.101
+  # perl Makefile.PL
+  # make test
+  # make install
+  # cd ..
+  #
+
+
+
   Do not fall into the trap of thinking they're all the same, just
   because they nearly are! Pay particular attention to the instructions
   of IO, above.
@@ -234,7 +241,7 @@
 
 
 
-       # vi /etc/group                (or your favorite editor)
+  # vi /etc/group                (or your favorite editor)
 
 
 
@@ -292,15 +299,14 @@
   Using the distributed DXVars.pm as a a template, set your cluster
   callsign, sysop callsign and other user info to suit your own
   environment.
-
-
-
        $mycall = "GB7DJK";
 
 
 
-  This is the call sign of your cluster.  If you use an SSID then
-  include it here also.
+  This is the call sign of your cluster.  Here in the UK we have
+  separate callsigns for our cluster nodes. If you can't use a different
+  callsign I suggest you use an SSID of '-2' for the node callsign
+  '$mycall'.
 
 
 
@@ -359,6 +365,9 @@
   use it though it has to be "made".  CD to /spider/src and type make.
   You should see the output on your screen and hopefully now have a
   small C program called client.  Leave it in this directory.
+
+
+
   1.6.  Starting up for the first time
 
   We can now bring spider up for the first time and see if all is well
@@ -406,7 +415,7 @@
 
 
 
-       shutdown
+  shutdown
 
 
 
@@ -469,6 +478,7 @@
 
   o  Enter the correct line in /etc/services (root)
 
+
   o  Enter the correct line in /etc/inetd.conf (root)
 
   o  killall -HUP inetd (root)
@@ -535,8 +545,6 @@
   There are 2 main node packages in use of which I shall keep to the
   original by Tomi Manninen, OH2BNS as this is included in the ax25 rpms
   as standard.  The other is AWZNode by IZ5AWZ.
-
-
   NB: The AX25 stuff in 2.4 kernels appears to have been broken until
   2.4.18.  I strongly suggest you get at least this kernel.
 
@@ -609,6 +617,8 @@
   NOTE:- before we start it is important to realise that every interface
   requires a different SSID.  You should be able to follow this in the
   following examples.
+
+
   3.5.  axports
 
   This file sets up the ax25 ports you want to use.  An example is below
@@ -657,6 +667,7 @@
   The file headings are as follows ...
 
 
+
   portname        -       The name you will refer to the port by
   callsign        -       This is the callsign that NET/ROM traffic from this
                           port will use
-- 
2.34.1