X-Git-Url: http://git.kpe.io/?p=cl-modlisp.git;a=blobdiff_plain;f=doc%2Freadme.html;fp=doc%2Freadme.html;h=e88ff1f152a798838160a38a18bfb7d2ea08c258;hp=0000000000000000000000000000000000000000;hb=3cd1fc37754064befbc4e5e9050ed8849da3ce09;hpb=f0aefda1754a567f9a42fce25c5a9b05cc1ab4f4 diff --git a/doc/readme.html b/doc/readme.html new file mode 100644 index 0000000..e88ff1f --- /dev/null +++ b/doc/readme.html @@ -0,0 +1,4 @@ + + +cl-modlisp readme

cl-modlisp Documentation

Overview

cl-modlisp provides the Lisp side of the interface to Marc Battyani's mod_lisp apache module (http://www.fractalconcept.com).

Features

support of AllegroCL, CMUCL, SBCL with sb-thread, and Lispworks.
listener and worker socket/process management so that shutting down the listener closes all related open sockets and terminates all related proceses.
support for running multiple command processors on multiple ports.
transparent support for precomputing the HTML or XML response to take advantage of HTTP/1.1's Keep-Alive feature. This is switchable with a single keyword argument to the macro with-ml-page.
Demonstration processor included

Prerequisites

Apache 1.3.x
mod_lisp apache module (http://www.fractalconcept.com).
kmrcl library (http://files.b9.com/kmrcl).
asdf (http://www.sf.net/projects/cclan).

Supported Platforms

Allegro v6.2
CMUCL 18e
Lispworks v4.2
SBCL 0.8.1 with sb-thread (multi-threading)

Quickstart

The easiest way to install is to use the Debian GNU/Linux operating system. Using the testing or unstable distributions, you can give the command:
apt-get install libapache-mod-lisp cl-modlisp cl-kmrcl
If you are not using Debian, you will need to download and install +mod_lisp, cl-modlisp, and cl-kmrcl manually.
Add something like the below to httpd.conf and then restart apache
LispServer 127.0.0.1 20123 "localhost"
AddHandler lisp-handler .lsp
Start your Lisp implementation and load cl-modlisp with
(asdf:operate 'asdf:load-op 'modlisp)
Start the server with
(ml:modlisp-start :port 20123)
Try some demostration pages
links http://localhost/fixed.lsp
links http://localhost/debug.lsp
Shutdown the all cl-modlisp servers with
(ml:modlisp-stop-all)

Usage

The demo.lisp file for some examples of using cl-modlisp.

\ No newline at end of file