AUTHORS:  Katherine White, University of Tennessee, Knoxville, Tennessee
             DOE ERULF Program, Summer 2002
          Adam Griffith, Rice University, Houston, Texas
             HERE-at-ORNL Program, Summer 2002

VERSION:  GuiRecess version 1.0
          Jar file packaged on August 19, 2002 (08/19/2002)

          This is the initial version of GuiRecess.  Keep in mind that there may be
          some bugs left to work out.  It is always recommended to CHECK THE OUTPUT in
          the recess_input and current_element_input programs to verify that things are
          more or less as they should be.  Things to be wary of are:

          * extra recesses or currents, such as deleted ones that were output anyway
          * negative mode numbers, mmax and nmax should be > 0
          * negative width or height values

LANGUAGE: Java 2 version 1.3.1 (J2SE 1.3.1)

REQUIRED: Java 2 1.3.1 or higher Java Runtime Environment (JRE) required for execution.
          Java 2 1.3.1 or higher Java Software Developer Kit (SDK) required for
          editing/compiling of code.  (Program can be used without the SDK)

PURPOSE:  to gather the information necessary for creating the input files for the
          rant3d fortran code

INPUT:    values for front, depth, width, height, mmax, and nmax, etc. for each recess.  
          Some of these are gathered from the keyboard, and some from the mouse.  Also 
          gather input values for position, dimension, current, phase, etc for currents.

OUTPUT:   the recess_input and current_element_input files that are read by the rant3d.f 
          program.  Also create a recess.obj file for use with the WireFrame demo.

USAGE:    Below are several different ways to use the program file.  To run the program,
          only the first of the following commands is needed or recommended.  The rest of
          the commands are for users wishing to study or edit the code.  
          Remember, EDIT THIS PROGRAM AT YOUR OWN RISK!

          1) To execute the program, type on the command line:

               java -jar GuiRecess.jar


          2) To view the GuiRecess.jar contents, type:

               jar tf GuiRecess.jar


          3) To extract the entire contents of the GuiRecess.jar file:

               jar xf GuiRecess.jar


          4) To extract the *.class compiled program files, type:

               jar xf GuiRecess.jar *.class

             To run the extracted program, type:

               java GuiRecess


          5) To extract the *.java source files, type:

               jar xf GuiRecess.jar *.java

             To compile the extracted source files, type:

               javac *.java

             To run the compiled program, type:

               java GuiRecess


          6) To compile an executable *.jar file:

               jar cmf (mainClass) (destination) (sources)

             Where (mainClass) is a file with the contents:

               Main-Class: (classname)

             And (classname) is the name of the executable class,
             (destination) is the name of the destination file (GuiRecess.jar)
             (sources) are the files to be compiled.

             Example: if the entire contents of the GuiRecess.jar program have
             been extracted to a directory, the following command would compile
             them into the file GuiRecess2.jar:

               jar cmf mainClass GuiRecess2.jar *.java *.class mainClass README.txt

             You can see that (mainClass) = mainClass
                              (destination) = GuiRecess2.jar
                              (sources) = *.java *.class mainClass README.txt