[updated for the brave new cclan world
dan**20010628135117] {
hunk ./doc/installation.html 8
-<p>Nobody has really got nice clean installation sorted out for CL
-programs, AFAICS.  I tend to take the view that exposing people to the
-gritty Lisp details is probably more constructive than wrapping it all
-up in shell scripts that don't work on anyone else's system.  So,
-installation takes a bit of fiddling and it helps to have used
-mk-defsystem before.
+<p>There are two routes to installation
+
+<h2>The Easy Way</h2>
+
+<p> If you're using Debian GNU/Linux 'woody' or 'sid',  you can add
+the address of your nearest <a href="http://cclan.sourceforge.net/"
+>cCLan mirror</a> to <tt>/etc/apt/sources.list</tt>, then <tt> apt-get
+update; apt-get install araneida</tt>
+
+<p>Now you can skip to <a href="#use">Use</a> below
+
+<h2>The Hard Way</h2>
+
+Otherwise, you need to read the rest of this:
hunk ./doc/installation.html 24
+
+<li>You need a CMUCL or SBCL implementation that has mk-defsystem
+loaded into it.
+
+<li>From <a href="http://cclan.sourceforge.net/debian/source/"
+>http://cclan.sourceforge.net/debian/source/</a> or mirror thereof you need
+
+<ul>
+<li>cl-db-sockets_0.43.tar.gz
+<li>cl-net-telent-date_3.tar.gz 
+<li>araneida_0.53.3.tar.gz
+</li>
+</ul>
+
+<li>Untar these files somewhere and define logical path translations
+so that <tt>CL-LIBRARY:DB-SOCKETS;</tt>,
+<tt>CL-LIBRARY:NET-TELENT-DATE;</tt> and <tt>CL-LIBRARY:ARANEIDA;</tt>
+point to the appropriate places.
+
+<li> Make your defsystem know how to find the system files.  This
+probably means putting symlinks to them into the current directory or
+a directory in your <tt>*central-registry*</tt> list (see mk-defsystem
+docs).  
+
+<li> You should now be able to build the systems with 
+<tt>(make:compile-system 'araneida)</tt>
+
+<li> Congratulations.  It's now working
+
+</li>
+</ol>
hunk ./doc/installation.html 56
-<li> Make your defsystem know how to find araneida.system.  This
-probably means putting it into the current directory or a directory in
-your <tt>*central-registry*</tt> list (see mk-defsystem docs).  The
-`just-playing' short cut, incidentally, is to <tt>load</tt> it into
-lisp before executing any <tt>load-system</tt> forms
+<h2><a name="use">Use </a></h2>
hunk ./doc/installation.html 58
-<li> Work out what Lisp thinks your FQDN is
+<p>Oh, you wanted to be able to actually use it?
hunk ./doc/installation.html 60
-<pre>
-* (ext:host-entry-name (ext:lookup-host-entry (unix:unix-gethostname)))
-</pre>
+<ol>
+<li> There are example handlers in the <tt>examples/</tt> subdirectory
+(Debian binary users will find them in
+<tt>/usr/share/doc/araneida/examples/</tt> directory).  Copy them to a
+scratch directory, and arrange matters such that the system definition
+in araneida-examples.system is valid (probably simplest just to edit
+the source-pathname to reflect the actual location of the samples)
hunk ./doc/installation.html 68
-It will probably help if this is correct, for at least some value of
-``correct''.
+<li>Edit <tt>per-host.lisp</tt> to have appropriate values for your
+local setup.  You can override any setting in <tt>variables.lisp</tt> 
hunk ./doc/installation.html 71
-<li> You need to provide appropriate values for your host for the
-variables in <tt>examples/variables.lisp</tt>.  So that you can keep settings
-for multiple hosts, these are stored in <i>(your hostname with dots
-replaced by hyphens)</i><tt>.lisp</tt> - see e.g.
-<tt>tninkpad-telent-net.lisp</tt>.  Create the appropriate file in the
-<tt>examples</tt> directory
+<li><tt>(make:compile-system 'araneida-examples)</tt>
hunk ./doc/installation.html 88
-
-<li> <tt>(make:compile-system 'araneida)</tt>
-
-<li> <tt>(make:compile-system 'araneida-examples)</tt>
hunk ./doc/installation.html 105
-badly broken these instructions are.
+badly broken these instructions are.  And, ideally, in what way
+they're broken.
hunk ./doc/installation.html 110
-I'd like to say that there's a mailing list for Araneida users that
-you can post to with installation problems and success stories.  As
-there's currently only one Araneida user that I'm aware of, I haven't
-taken the time to set it up yet.
}