Update history is given at the end of this readme file.

JSane is a Java-based frontend for the SANE (Scanner Access Now Easy) scanner
backend program.  An external viewer program such as PMView is required to
print scanned images, and a fax program such as Faxworks Pro is needed for faxing.

It was written for personnal use and is provided here "as is".

It has been tested on my system (a PP180 cpu with 64k ram with a SCSI-based
HP-4p flatbed color scanner) using Java 1.1.8.  See the accompanying text file,
notes.doc, for acknowledgements and other information.  Copyright information is
in the text file, about.doc.

Features include a preview mode with cropping, and multi-page
files for faxing.  A text file is used to tailor the scanimage.exe options for
specific scanning devices.

------------------------ Installation ------------------------------
1.  Install Java 1.1.8 or better.

2.  Unzip the file jsane021.zip to some working directory such as "D:\Jsane"
    The following files are included in this distribution:

      jsane.jar   - The Jsane Java archive file.
      about.doc   - A text file used by Jsane.
      notes.doc   - A text file used by Jane.
      hp.conf     - A configuration file read by scanimage.exe
      hp.options  - a text file read by Jsane to configure scanimage.exe options.
      Jsane.cmd   - Quick launch of Jsane
      Install.cmd - Creates a Jsane program object on the desktop (see "Running
                    Jsane" below)
      readme      - This file

3.  Obtain and install Freedman's OS2SANE version 0.66 Release one including
    the associated ASPI router by Dorau. (sane661.zip)  The following two
    sane files should be included in the working directory.

      scanimage.exe - the SANE backend program
      libsane.dll   - a library file for scanimage.exe

4.  The hp.conf configuration file consists of a single line for my HP 4p
    scanner.  Search sane documentation and notes for other configurations.
    The "hp" prefix is specified under Jsane Configuration/Device menu and is
    passed on as an argument to the scanimage.exe program.
   
5.  The hp.options file, hp.options, should be edited and renamed for the
    specific scanning device.  Again, the prefix is obtain from the
    Configuration/Device menu.

6.  Additional files that can be created by the program include:
      jsane.ini   - Initialization file
      Default.set - Default settings
      Fax.set     - Fax settings

7.  If problems are encountered running Jsane after a failed initial attempt,
    it is a good idea to delete jsane.ini and all *.set files.

------------------------ Running Jsane ------------------------------
1a. If jsane.jar is in the Java classpath, then the program may be executed from
    the working directory by the command line:

       java Jsane

    The "java" command may be replace by "jre" depending on your installation.

1b. As an alternative, the command file, Jsane.cmd, temporarily adds jsane.jar
    to the classpath and launches Jsane:

       set classpath=%classpath%jsane.jar;
       java Jsane
    A more robust procedure is to replace jsane.jar with its full path.

1c. The Install.cmd file can be run to create an OS/2 program object on the
    OS/2 desktop that can be used to launch Jsane.  The jsane.jar file must be
    included manually in the Java classpath since Install.cmd does not modify
    the config.sys file.

2.  On initial startup, a request is made to create an Images subdirectory.
    Also, a Default settings file, Default.set, and a Fax settings file,
    Fax.set should be saved from the "Settings" menu if they do not exist.
    Important: The "*.set" extensions are added internally and should not be
    typed.

    For example, to save new Fax settings:
      a.   Change the Directory (under the "Settings" menu) to the one desired
           for saving fax images.
      b.   Set the resolution to 200 x 200 dpi, and
      c.   enter "Fax" when requested by the "Settings->save" menu

------------------------ Additional Notes -------------------------------
The Java CLASSPATH environment variable is the source of many intallation
problems.  Early versions of Java required the CLASSPATH to have the full
path and name to the Java class libraries, classes.zip, as in
X:\Java11\lib\classes.zip.  With Java 1.1.8, the classes.zip file is
found automatically; however, the full path and name of any Java Archives
should be given.  For example X:\...\jsane.jar.  Files names in Java are
case sensitive.

A further complication is that the CLASSPATH variable may be overridden on
the java command line with the -classpath option.  In that case, however,
the classes.zip file must be explicitly included as well as any Java
Archive files separated by semicolons.

------------------------ Revision History -------------------------------
July 1998 - Version a: Initial release for Java Version 1.1.4

10/19/2000 - Version 0.1: Minor changes were made to allow program to run with
Java Version 1.1.8.  My Thanks to Klaus Staedtler for testing Jsane with sane
Version 1.01.

11/02/2000 - Version 0.2:  Made the scanner options settings customizable with
the aid of a new text-based option-configuration file.  Provided support for
metric units.

11/11/2000 - Version 0.21  Several bug fixes associated with adding the new
option-configuration file, DEVICE.options.

---------------------------------------------------------------
Frank Schmittroth (July 1998)
franks@owt.com
