                    README for JavaComplex.zip
                    --------------------------

                 ORG.netlib.math.complex.Complex

                        version 1.0 FINAL



    You've downloaded JavaComplex.zip from Netlib, or at least, got
hold of a copy.


    JavaComplex.zip when unzipped expands to



        JavaComplex
        
        +---ORG
               readme.txt
            
            +---netlib
                +---math
                    +---complex
                           Complex.class
                           ComplexBenchmark.class
                           readme.txt
                           TestComplex.class
                        
                        +---api
                              ORG.netlib.math.complex.Complex.html
                           
                           +---classes
                           +---images
                        
                        +---src
                                Complex.java
                                ComplexBenchmark.java
                                TestComplex.java



    In order to use Netlib's Complex Class, you must make sure that the
Class is accessible from your local machine's Java CLASSPATH.  For PC
users, the CLASSPATH is usually set in autoexec.bat.  There are two
ways to go about this, one "bad", and one good.  The "bad" way is to
yet again add a new folder to your CLASSPATH.  I try not to do this.


    The good way is to have in your CLASSPATH a general package
directory, where third-party packages can simply be downloaded and
slotted in.  Here's an illustration:


    This is my CLASSPATH on Windows NT:


        CLASSPATH=.;G:\java\LIB\CLASSES.ZIP;G:\Program_Files\Java\packages


    In the folder "G:\Program_Files\Java\packages", I have, at the
moment, four subfolders:


        COM
        JavaCC
        ORG
        test.my


    Down the COM folder is, at present, just ObjectSpace's Java Generic
Library, down the ORG folder, funnily enough, is _already_ Netlib's
Complex Package (!)  (JavaCC is a compiler-compiler tool from Suntest,
and test.my is obviously where I try things out.)


    So the good way to make Netlib's Complex Class accesible on your
local machine is to slot in netlib.org's Complex Class down the ORG
folder, making sure you are not overwriting any existing folders, just
adding to them.


    So, illustrating from my own system, down the packages folder I
have:



        packages
        
        +---COM
           +---objectspace
               +---jgl
        
        +---JavaCC
           +---bin
        
        +---ORG
           +---netlib
               +---math
                   +---complex
                       +---api
                       +---src
        
        +---test.my
            +---util



    Next time I download a third-party package, it will neatly slot
into this scheme somewhere, probably either down the COM or the ORG
folders.  Very possibly, it could be another package from Netlib.


    Once you have got Netlib's Complex Class slotted in to your
CLASSPATH, in the manner I've just illustrated, and done any rebooting
(if that's necessary on your system), you're now free to read the API
for Complex, run the tester program for it, and basically, it's ready
to be used in your Java work.  A quick check to test everything's now
OK, is to enter the command line:


        > java ORG.netlib.math.complex.TestComplex


and you should get


        Tester...
        Module : ORG.netlib.math.complex.TestComplex
        Version: 1.0 alm

        Testing...
        Module : ORG.netlib.math.complex.Complex
        Version: 1.0 FINAL alm
        Date   : Fri 29-Jul-97
        Author : sandy@almide.demon.co.uk
        Remark : Class available from http://www.netlib.org/

        usage  : java TestComplex method [a] [bi] [c] [di]


in reply.


With Best Wishes,




Sandy

/*  Correct my address in any reply, or it'll be treated as spam:
--
//     Alexander Anderson    <DELETE_THIS.sandy@almide.demon.co.uk>
//     Home Fone                               +44 (0) 171-794-4543
//     London, UK                    http://www.almide.demon.co.uk/
//     PGP print   C6 8C 55 F2 77 7B 99 9B  14 77 66 F5 B8 74 CF 12
*/
