$Id: readme.txt,v 1.4 2000/02/10 01:25:01 gelderen Exp $


Cryptix JCE 
============

NOTE: The contents of this .zip-file are for testing purposes only. 
      Please do not distribute this file or it's contents to end-users.
      

Contents
--------

src/*                            Sources

bin/cryptix-jce-api.jar        The JCE API. 
                                 (javax.crypto....)

bin/cryptix-jce-compat11.jar   The JDK 1.1 compatibility classes.
                             
bin/cryptix-jce-provider.jar   The Cryptix Strong Crypto Provider.
                               (cryptix.jce... except cryptix.jce.test)
                              
bin/cryptix-jce-tests.jar      Cryptix JCE Test Suite
                                 (cryptix.jce.test....)


Build
-----

Be brave, all I can say is that It Works For Me. The build process is clumsy
and somewhat involved because of the JDK 1.1 vs. 1.2 cross-compilation and a
broken javac in JDK 1.1.

You need to install JDK 1.1.x, JDK 1.2 and Python version 1.5.2 in order to
build. Installing Jikes is recommended because it's much faster than javac.

Set up your environment as follows:
  set CLASSPATH   = <your JDK 1.1 or JDK 1.2 classpath>
  set CLASSPATH11 = <your JDK 1.1 classpath>
  set PATH        = <must point to the JDK 1.2 binaries>
  set JAVAC       = <name of your compiler executable. usually javac or jikes>
  set JAVAC_FLAGS = <optimization flags passed to the compiler>

Execute the make.py script:
  python make.py dist
and pray that it works. Output files are generated in build/*.


Install
-------

JDK 1.2: Throw the .jar files (except compat11) in your $JDK/jre/lib/ext 
         directory. If you don't know where that is, you should not be using 
         this pre-release software.

         Alternatively you can put the .jars (except compat11) in your 
         CLASSPATH. This can come in handy for testing purposes.
         
JDK 1.1: Put all 4 .jars in your CLASSPATH


You can test your installation by running something like:
    java cryptix.jce.test.Test All
                                 
                                 
Feedback
--------
All is welcome. To: gelderen@cryptix.org
