Jigsaw 1.0 alpha
----------------

Jigsaw is a new http server, written entirely in Java. Unlike most
other servers, Jigsaw is truly object-oriented: each resource exported
by Jigsaw exists through a physical Java object which is responsible
for processing requests targeted to its own URL.

Due to this original architecture, Jigsaw's configuration process is
not the one you are used to see in file-based servers, this is why
this README starts by this warning: 

    Read the documentation first !

Running the server:
-------------------

To read the documentation, you will have to first run Jigsaw, the
simplest way of doing so is the following:

0) Get a Java interpreter and install it.
   For the time being, the Sun Java interpreter is probably the only
   one available. You can get it from:
   
     http://www.javasoft.com

1) Set your CLASSPATH environment variable in order to include
   Jigsaw's classes. To do this:
   
     On Windows
       set CLASSPATH=<instdir>/Jigsaw/classes/jigsaw.zip
     On UNIX
       export CLASSPATH=<instdir>/Jigsaw/classes/jigsaw.zip

   Where <instdir> should be substitued with the absolute path of the
   directory in which you unpacked Jigsaw.

2) Check that your PATH setting allow you to run the Java
   interpreter. This will usually be the case if you have installed
   Sun's JDK.

3) Run the server:

     On Windows
       java w3c.jigsaw.http.httpd -root <instdir>/Jigsaw/Jigsaw
     On UNIX
       java w3c.jigsaw.http.httpd -root <instdir>/Jigsaw/Jigsaw

4) Point your browser to the server's home page. At step 3), the
   server will have emited the full URL it is listening on, just point
   your browser to this URL and follow the instructions.

Submiting bugs, giving feedback:
--------------------------------

Send bugs, feedbacks, contributions, etc to:

    jigsaw@w3.org

The www-jigsaw@w3.org mailing list is an open forum for dicussing Jigsaw 
related issues, come and join us !

Enjoy !

Anselm.
      
