[updated for asdf system dan**20020307000515] { hunk ./doc/installation.html 8 -

There are two routes to installation - -

The Easy Way

- -

If you're using Debian GNU/Linux 'woody' or 'sid', you can add -the address of your nearest cCLan mirror to /etc/apt/sources.list, then apt-get -update; apt-get install araneida - -

Now you can skip to Use below - -

The Hard Way

- -Otherwise, you need to read the rest of this: +

Araneida is distributed as an ASDF System. You +may want to investigate whether there is a convertor from ASDF systems +to your platform's package standard, in which case installation will +be a simple matter of apt-get or pkg_add or something and you can skip +to Use. Otherwise, read on ... hunk ./doc/installation.html 16 - -

  • You need a CMUCL or SBCL implementation that has mk-defsystem -loaded into it. +
  • You need a CMUCL or SBCL implementation that has asdf loaded into it hunk ./doc/installation.html 19 -
  • From http://cclan.sourceforge.net/debian/source/ or mirror thereof you need +
  • From your favourite cCLan +mirror, download cl-db-sockets, +net-telent-date and araneida, and +untar them somewhere. hunk ./doc/installation.html 25 - +
  • Create symlinks to the unpacked .asd files in a directory on your +asdf *central-registry* list. For example hunk ./doc/installation.html 28 -
  • Untar these files somewhere and define logical path translations -so that CL-LIBRARY:DB-SOCKETS;, -CL-LIBRARY:NET-TELENT-DATE; and CL-LIBRARY:ARANEIDA; -point to the appropriate places. +
    +* asdf::*central-registry*
    +(*DEFAULT-PATHNAME-DEFAULTS* "/home/dan/src/defsystems/")
    hunk ./doc/installation.html 32
    -
  • 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 *central-registry* list (see mk-defsystem -docs). +$ cd /home/dan/src/defsystems/ +$ ln -s ../telent/araneida/araneida.asd ../telent/net-telent-date/net-telent-date.asd ../telent/db-sockets/db-sockets.asd . +
  • hunk ./doc/installation.html 36 -
  • You should now be able to build the systems with -(make:compile-system 'araneida) +
  • You should now be able to compile and load the systems with +
    +* (asdf:oos 'asdf:load-op 'araneida)
    +
    hunk ./doc/installation.html 51 -
  • There are example handlers in the examples/ subdirectory -(Debian binary users will find them in -/usr/share/doc/araneida/examples/ 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) + +
  • There are example handlers in the examples/ subdirectory. +Copy them to a scratch directory, and symlink the araneida-examples.asd +file into somewhere on *central-registry* (as before) hunk ./doc/installation.html 59 -
  • (make:compile-system 'araneida-examples) +
  • (asdf:oos 'asdf:load-op 'araneida-examples) hunk ./doc/installation.html 69 -NameVirtualHost localhost +NameVirtualHost noetboot.telent.net hunk ./doc/installation.html 72 -(localhost should usually be the machine's actual hostname, -but this thing has to run both standalone and on two different -networks, and it's too much of a headache to make it behave entirely -reasonably) hunk ./doc/installation.html 89 -badly broken these instructions are. And, ideally, in what way -they're broken. +badly broken these instructions are. And, ideally, in what ways. + }