         =================================================
         =    README for OS/2 version of A2PS 4.10.x     =
         =================================================

                      (19980908)


            CONTENTS OF THIS DOCUMENT:

            1) What is A2PS ?
            2) What about the OS/2 version ?
            3) Contents of this archive:
            4) Installation
            5) Building a2ps for OS/2
            6) Additional information



1) What is A2PS ?
   ************

Check out the supplied documentation, especially README to learn
about A2PS.


2) What about the OS/2 version ?
   ***************************

To get this utility built under OS/2 I had to work around the 
configure stuff which didn't work even using the latest Autoconf
port. By now (almost) no changes are done in the source itself,
though I contacted the author to consider what can be done to
ease the installation.

The National Language Support (NLS) for the executable's language
dependent resources is not include here and I don't offer a
shared library (dll) since I can see no further use for this library yet.


3) Contents of this archive:
   ************************

 - the binary of a2ps for OS/2
 - the supplied shell scripts with a REXX wrapper. You need
   an installed un*x shell anyway to run them.
   NOTE: not all those utils may be included here actually!
 - all data files for encoding, pretty printing, font selection, ...
 - documentation in GNU info format and man pages as well as
   documents regarding general issues (copyright, license,
   changelog, ...)


4) Installation:
   ************

  - Put a2ps.exe in the path and the manpage in the manpath.
  - Place a2ps.cfg and the subdirectories anywhere on your disk.
  - Set the environment variable A2PS_CONFIG to point to the
    directory where a2ps.cfg can be found.
  - Edit a2ps.cfg to fit your installation. The most critical
    items are 'LibraryPath' (which has to include all those
    directories mentioned above) and the command to print out.
    In the given example I use lpr and lpd to access one of
    Postscript printer queues from the commandline. "lp" is 
    a kind of an alias for "lpr.exe -b -p HP5MPPSQ -s localhost"
    where HP5MPPSQ is one my Postscript printer queues.
    If can't work out something similar, try out starting
    ghostview or print to a file first. You may want to use
    "lportd" or tools like printmon.zip (from LEO).


5) Building ap2s for OS/2
   **********************

If you want to compile it yourself you will likely run into trouble
using configure as even the Autoconf port fails on this stuff.
Either you manage to fix the configure script yourself or
you have to create suitable versions of 
  config.h
and 
  Makefile.
Or you can ask me for my versions of config.h and Makefile ;-)



6) Additional information:
   **********************

The latest compiled version can be found on my webpages listed below.
(there you can also find the utility 'file' which a2ps likes to call
to guess the the file type)

Let me know if you experience any trouble using this tool under OS/2!


Alexander Mai
am@os-2.de
st002279@hrzpub.tu-darmstadt.de
WWW: http://www.os-2.de/~am
     http://www.tu-darmstadt.de/~st002279
