doc.txt

Instaweb : Instant Web Publishing Tool

Instaweb : Instant Web Publishing Tool
======================================

By Noel Welsh (noelwelsh at yahoo dot com) 

This manual documents Instaweb version 1.0
Time-stamp: <05/12/29 16:31:38 noel>

Keywords: _instaweb_, _servlet_, _internet_, _web_


Introduction
============

Instaweb is a simple tool that makes it easier to run
servlets in the PLT web server.

It does the following:

  - configures the web server to run a single servlet

  - runs the web server in a handy interactive shell


Usage
=====

Simply require the instaweb library, and call the function
instaweb with the name of the servlet you want to run, and
the port number to run the web server on.  The servlet must
be in the current directory.

Example:

  (require (planet "instaweb.ss" ("schematics" "instaweb.plt")))
  (instaweb "my-servlet.ss" 5678)


Caveats
=======

The web server requires servlets live in a directory called
servleets.  Hence instaweb creates this directory and copies
your servlet to it (and cleans up afterwards).  This means
if your servlet requires any modules using relative paths
those modules probably won't be found.  To get around this
put your support modules into a collection that you install
via a .plt or Planet.  Then require them with the (lib ...)
or (planet ...) form as appropriate.