Installing `ogonkify'
*********************

Please make sure that you are using the last version of this package,
which can be found on `ftp.dcs.ed.ac.uk' in the directory
`/pub/jec/programs'.  More information on the latest version can be
found on the World Wide Web on:

  <URL:http://www.dcs.ed.ac.uk/home/jec/ogonkify/>

This file assumes that you are using `ogonkify' standalone.  If you
are using the version of `ogonkify' included in `a2ps', `ogonkify'
should have been properly installed during the installation of `a2ps';
there is nothing more to do.

1. Unpack all the files in the distribution in a directory.

2. Check that you have a working `perl' executable (both versions 4
   and 5 should work).  It is usually in `/usr/local/bin/perl'.

3. If you want to use the `-CT' option, locate the IBM Courier `.pfa'
   files.  On my system, they can be found in the following places:

          /usr/local/lib/X11R6/fonts/Type1/cour*.pfa
          /usr/local/lib/X11R5/fonts/Type1/cour*.pfa
          /usr/local/share/TeX/gs/fonts/ncr*.pfa

   Make sure that they are the IBM Courier fonts, not the Adobe
   Courier ones.  Just check that they contain an IBM copyright
   notice.

4. Edit the `config' file.  You must have write permissions on the
   `$BINDIR', `$MANDIR' and `$LIBDIR' directories.  It is reasonable
   to have `$BINDIR' on your path.

5. In the directory where you unpacked the distribution, type:

          % sh ./instogonki

   The script should complete with no errors.  It will create the
   encoding vectors, the fonts with composite characters, and install
   all the files in the right places.  You might need to run catman
   to use the man page.

6. Ogonkify is now installed.  To print Netscape output (say
   CheGuevara.ps) with the Latin-2 encoding, simply type:

          % ogonkify -N -AT <CheGuevara.ps | lpr

   If, for a reason or another, you cannot format the man page, a
   plain text version is provided as doc/ogonkify.man.

7. In order to save space, you may now type

          % ./clean

   in the distribution directory.

