Copyright (c) 1998-1999 Caucho Technology. All Rights Reserved.

This is the README file for Resin(tm)
=====================================

The documentation for starting Resin is at doc/ref/starting.html

Questions should go to our mailing list.  To subscribe, send a mail to 
resin-interest-request@caucho.com with the body "subscribe".

You can also send us your questions, feedback and bug reports directly
resin@caucho.com

I) Preconditions

Resin requires Java before it can run.  Resin works either
JDK 1.1.x and JDK 1.2.  

To get a copy of the JDK, look at http://java.sun.com.

Linux users should check out http://www.blackdown.org. Or use the IBM JDK.

II Licensing

Resin 1.1 beta is open source.  Although purchasing a license
is not required to use Resin, future Resin development and support
depends on your financial support.  When the 1.1 beta completes,
professional users should see http://www.caucho.com to purchase a
license.  In other words, if you're being paid to use Resin,
you should (in the moral sense) buy a license from us.

Customers modifying or redistributing Resin, including other open
source projects, must read the license carefully to make sure your
redistribution satisfies the terms of the license.

III) HTTPD

This distribution provides a simple http server to evaluate Resin and
test JSP files.  

To start the server:

> resin1.1/bin/httpd.sh

The server listens at port 8080.

From your browser, browse the url http://localhost:8080 or equivalently
http://127.0.0.1:8080.

By default, the web server serves files from resin1.0/doc.  All
files with the extension '.jsp' are interpreted as jsp files.
Evaluating Resin is easy, just drop a new jsp file somewhere under
resin1.1/doc and browse the file.

IV) Configuration (unix)

Full details are in doc/ref/starting.html.  To install for Apache or
Netscape, you'll need to compile the plugins:

  configure --with-apache=/usr/local/apache \
            --with-netscape=/usr/local/netscape/https-your-hostname
  make

V) XSL

XSL can be run standalone as follows:

> java com.caucho.xsl.Xsl [-xsl stylesheet] [-o dest] file1.xml file2.xml ...

By default it uses XSLT rules.  For XSLT-list, add the '-list'
flag.
