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

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

The documentation included with Resin is in XTP format starting at
doc/ref/index.xtp with installation documentation at doc/ref/starting.xtp.

XTP assumes you've already got Resin working, so you should read this
README up to part III: Getting Started.  The full documentation is also
available online at http://www.caucho.com/products/resin/ref if you
have trouble getting started.

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 bug reports to bugs@caucho.com


I) Licensing
------------

Resin 1.2 is released under the Caucho Developer Source License.  For
pricing and licensing information, see /sales.xtp.

 o You may use Resin for development, evaluation, and demos.
 o You must contact us for a deployment license if either:
   * You are paid to use Resin.
   * You are paying someone else to use Resin.
 o If no one is paid to use Resin, you may use Resin for deployment
   without purchasing a license:
   * students
   * private use
   * tiny startups with neither funding nor income.
 o Anyone falling in between should contact us for a waiver.
 o Distributors must contact us.
 o If you are allowed to use Resin, you may modify the source for that use.


II) Preconditions
-----------------

1) Resin needs a Java JDK before it can run.  Resin works with JDK 1.1.x
and JDK 1.2.  You need the JDK, not the JRE because Resin needs the
Java compiler.  We also recommend using IBM's jikes compiler.
Some locations for good JDKs include:

  http://java.sun.com      -- Sun's site
  http://www.ibm.com       -- IBM's fast 1.3 JDKs for Linux
                           -- We recommend also using The jikes compiler.

2) On Unix, Resin's wrapper.pl script expects Perl 5.

3) On Windows, you'll need an unzip tool available at http://www.winzip.com


III) Getting Started
--------------------

Start your Resin evaluation with Resin's included httpd server
even if you plan to use Resin with another web server.

The included HTTP/1.1 server makes it easy to evaluate Resin, JSP
and servlets.  Just start it up.  The default configuration
files can be used without modification.

1) To start the server:

     unix> resin1.2/bin/httpd.sh

   or

     c:\> resin1.2/bin/httpd

   The server listens to port 8080.

2) Browse http://localhost:8080 or equivalently http://127.0.0.1:8080.

3) Go through the tutorial at http://localhost:8080/java_tut.

4) Run through the demos at http://localhost:8080/examples

5) For JSP, create test.jsp in resin1.2/doc/test.jsp and browse
   http://localhost:8080/test.jsp.

   Resin serves files from resin1.2/doc in the default configuration.
   All files with the extension '.jsp' are interpreted as jsp files.

6) For Servlets, create resin1.2/doc/WEB-INF/classes/HelloServlet.java
   and browse http://localhost:8080/servlet/HelloServlet

   Resin automatically compiles Java classes in resin1.2/WEB-INF/classes.  
   Add the servlet source in WEB-INF/classes and browse.


IV) Plugin Configuration (unix)
-------------------------------

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

Full details are in doc/ref/starting.html.


V) Plugin Configuration (windows)
---------------------------------

To install Resin with IIS, Apache or Netscape, use

  c:\> resin1.2\bin\setup

Resin will also work with the O'Reilly WebSite.

Full details are in doc/ref/starting.xtp.


VI) 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 StyleScript, add the '-stylescript'
flag.
