;;; -*- Mode: Lisp -*-

(in-package #:lml2)

(page ("readme")
  (html      
   (:head
    (:title "cl-modlisp readme")
    ((:meta :http-equiv "Content-Type" :content "text/html; charset=iso-8859-1"))
    ((:meta :name "Copyright" :content "Kevin Rosenberg 2002 <kevin@rosenberg.net>"))
    ((:meta :name "description" :content "cl-modlisp documentation"))
    ((:meta :name "author" :content "Kevin Rosenberg"))
    ((:meta :name "keywords" :content "Common Lisp, mod_lisp, cl-modlisp, apache")))

   (:body
    (:h1 "cl-modlisp Documentation")
    (:h2 "Overview")
    (:p
     "cl-modlisp provides the Lisp side of the interface to Marc Battyani's mod_lisp apache module ("
     ((:a :href "http://www.fractalconcept.com") "http://www.fractalconcept.com")
     ").")
    (:h2 "Features")
    (ul
     (li "support of AllegroCL, CMUCL, SBCL with sb-thread, and Lispworks.")
     (li "listener and worker socket/process management so that shutting down the listener closes all related open sockets and terminates all related proceses.")
     (li "support for running multiple command processors on multiple ports.")
     (li "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 "
	 (:tt "with-ml-page")
	 ".")
     (li "Demonstration processor included"))
    (:h2 "Prerequisites")
    (ul
     (li "Apache 1.3.x")
     (li "mod_lisp apache module ("
	 ((:a :href "http://www.fractalconcept.com")
	   "http://www.fractalconcept.com")
	 ").")
     (li "kmrcl library ("
	 ((:a :href "http://files.b9.com/kmrcl")
	   "http://files.b9.com/kmrcl")
	 ").")
     (li "asdf ("
	 ((:a :href "http://www.sf.net/projects/cclan")
	   "http://www.sf.net/projects/cclan")
	 ")."))

    (:h2 "Supported Platforms")
    (ul
     (li "Allegro v6.2")
     (li "CMUCL 18e")
     (li "Lispworks v4.2")
     (li "SBCL 0.8.1 with sb-thread (multi-threading)"))

    (:h2 "Quickstart")
    (ul
     (li "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.

2. Add something like the below to httpd.conf and then restart apache
      LispServer 127.0.0.1 20123 "localhost"
      AddHandler lisp-handler .lsp

3. Start your Lisp implementation and load cl-modlisp with 
   (asdf:operate 'asdf:load-op 'modlisp) 

4. Start the server with 
      (ml:modlisp-start :port 20123))

5. Try some demostration pages
      lynx http://localhost/fixed.lsp
      lynx http://localhost/debug.lsp

6. Shutdown the all cl-modlisp servers with
     (ml:modlisp-stop-all)


USAGE
-----

Return to the demo.lisp file for some examples of using cl-modlisp.