README for XSane 0.992 for OS/2:
================================

 This is the 20. Version of XSane for OS/2.
 It may have bugs. It is not tested very well
 but short tests looked very good (At least for me ;-).
 It works with XFree86 as well as with HOBLink X11 for OS/2.

 I am interested in any feedback positive or negative!
 Send me a mail: fbakan@gmx.net

 This version supports:
  - preview scan, preview zoom
  - scan and save to pnm, jpeg, png, tiff, ps, pdf and raw file
  - handling of all backend options
  - helpfiles
  - copy mode (printing via ghostscript, see section "copy mode")
  - ocr output to a textfile using gocr.exe
    ( http://www.fbakan.de/gocr-os2.htm )
  - gimp-plugin (only for GIMP2)

 It do not know if it supports:
  - fax mode (is there compatible faxsoftware?)

Installation:
=============
 - this version is compiled with gcc321
   ( ftp://ftp.netlabs.org/pub/gcc/gcc-3.2.1-r2 ),
   so you need it's runtime-dll gcc321m.dll.
   If you don't have it, you can download it here:
   http://www.fbakan.de/xsane/gcc321m.zip

 - you need to have gimp2.2 installed (even if you don't use it)

   for the details see:

   http://hobbes.nmsu.edu/cgi-bin/h-viewer?sh=1&fname=/pub/os2/apps/graphics/gimp/gimp-2.2.8.zip

 - you need all these DLLs even if you run XSane standalone
   and not as GIMP2-Plugin!

 - I didn't bother to check if this list is complete.
   If XSane complains about some DLL missing or dies with an entry in
   popuplog.os2, just ask me.

 - You need a recent version of libsane.dll (1.0.16 or later)
   in your LIBPATH and SANE has to be set up correctly.
   This means 'scanimage -L' should find your scanner.

 - try the latest version from Paul Smedley
   http://smedley.info/sane.html

 - If want a smaller libsane.dll just for your scanner, let me know
   and I'll try to build one for you.

 - Unpack/move the files from this xsane-0.992-OS2 package to your x:\usr tree.

 - XSane won't work if it does not find the files in \usr\share\sane\xsane
   *EXACTLY* in this place!

 - To get National Language Support (default is english language) you have
   to set (for example in your CONFIG.SYS or in a xsane-start.cmd)

   SET LANGUAGE=de  (for german language support)

   Supported langages are:

   ca cs da de es fr hu it ja nl pl pt pt_BR ro ru sk sl sr sv tr vi zh zh_CN

   and perhaps something like

   SET OUTPUT_CHARSET=latin1

 - to make 'help' work, you need to have a browser for X
   I use mosaic (it does not understand href="...#..." but is usable)

 - To make XSane work as Gimp-plugin copy x:\usr\bin\xsane.exe
   to  x:\usr\lib\gimp\2.0\plug-ins\xsane.exe

Copy-Mode:
==========
 If you want to use copy mode, you need ghostscript for OS/2.
 You can download it e.g. from http://www.cs.wisc.edu/~ghost/
 Enter Setup/Copy options:
 enter as command (for example):
  x:/gs/gs8.53/bin/gsos2 -sDEVICE=ljet4 -sPAPERSIZE=a4 -dNOPAUSE -sOUTPUTFILE=lpt1 -q -
 Pay attention: you have to use "/", don't use "\".
 You probably have to change
  sDEVICE=ljet4
 to match your printer.

 Don't forget to set
  SET GS_LIB=x:/GS/GS8.53/lib;x:/GS/FONTS;D:/PSFONTS  (example)
  SET GS_FONTPATH=x:/GS/FONTS;D:/PSFONTS  (example)
 in config.sys or the cmd-file that starts xsane

 To get a list of available device names, call
     x:\gs\gs8.53\bin\gsos2 -h

Mail-Mode:
==========
 If you want to use mail mode, I suggest that you use ee (electric eyes)
 if you want to display the image. 

Enable debug messages:
======================
 If something does not work you can enable debug-output by setting XSANE_DEBUG
 to a value between 1 and 128. Higher numbers give more messages.

 Enter from command-line for example:
 set XSANE_DEBUG=3
 xsane 2>log.3

 The error-messages are saved in log.3

If it doesn't work:
===================
 - Check if you have a valid scanner.conf file in SANE_CONFIG_DIR

 - Check if the right version of jpeg.dll is found.
   Newer versions of JAVA come with an incompatible version.

 - Have a look into popuplog.os2

 - If XSane windows don't close correctly try another Window-Manager.

Support:
========
 There is no special support for XSane for OS/2.
 But there is a mailing list. Search for sane-os2 at
 groups.yahoo.com. You can also ask me and perhaps I can help.

Licence:
========
 - XSane and XSane for OS/2 stand under the terms of
   the GNU general public licence (GPL).
   You can find the sourcecode for XSane at:
   http://www.xsane.org

 - The gtk-libraries that come with XSane also do stand under the terms of the
   GNU general public licence - GPL (gdk, gtk, glib, gnu-intl, gmodule)

 - The sourcecode of XSane can be found at http://www.xsane.org

 - The sourcecode of Sane can be found at http://www.sane-project.org


Compile it yourself:
====================
 - ask me

Thanks:
=======
 Thanks to Christian Hennecke for testing,
        to Frank Gieáler for GTK2 and XFree4.5.0
        and of course to Oliver Rauch for writing XSane and for his support.


Contact:
========
 You can contact the author of XSane via email: see /usr/doc/xsane/xsane.AUTHOR
 but don't ask for help/support for XSane on OS/2, He does not have the
 time to give support to it and wants to use his free time to
 work on the code - please understand that.

Franz Bakan  fbakan@gmx.net   26. January 2007
