This is the Amiga port of Ghostscript5.01. Ghostscript is a Postscript
interpreter with support for Level 2 PS and PDF. This release includes
most popular printers and fileformats including an updated Amiga display
driver.

Features:
Ghostscript supports three Amiga specific devices (but see below for ILBM):
	amiga           Amiga Workbench window
	amiga_custom    Amiga custom screenmodes
	amiga_printer   Amiga printer.device
(amiga_printer seems to have problems, please use one of the internal ones)
(redesign done by Steffen Opel opelsto.isdn.uni-mannheim.de)

The device 'amiga' opens an Intuition window on the Workbench screen to
display the image. Its usage should be pretty obvious.

The device 'amiga_custom' opens a Customscreen to display the image. This 
allows any Display Mode available in the screenmode preferences to be used
with Ghostscript too.

The device 'amiga_printer' is a convenient alternative for the printer devices
provided by Ghostscript itself. It facilitates standard Amiga printing via the
Workbench printer drivers and respects most settings in the graphics 
preferences as described in the Workbench documentation.

All three devices are supporting -g and -r as described in 'use.txt'.

Ghostscript currently has only limited support for IFF ILBM files:
	amiga_ilbm    IFF ILBM file format

The device 'amiga_ilbm' works like any other Ghostscript raster file or 
printer device (i.e. pbm), see 'Choosing the output device' above on how 
to specify an output file.
It supports dithered grayscale only and is not portable to other platforms 
because it uses iffparse.library. A portable implementation with color 
support is currently under development.

This port requires:
- An  Amiga  equipped Kickstart 2.04 or higher.
- Approx. 4.7 MBytes of hard disk space available.
- A  minimum  of 1 MByte of chip memory, depending on what you want to do
  with  the  interpreter.  Printer output requires at least 2 MBytes of
  contiguous memory (any memory, not necessarily chip memory).
- A bunch of Postscript/Ghostscript fonts.

Comments/Suggestions/Bugs to:
JoopvandeWegemail.mococo.nl
Please use a Subject field with the name 'GS501' in it.
Please direct all mail to me except when you're 100% sure it is a GS
problem then you can use the Aladdin email address.

Joop van de Wege


Getting Ghostscript.
Download one of the binary archives which match your CPU. It contains
one binary.You might need a patch which is only needed if:
- you have an 040
- and Kickstart 3.1
- and are *NOT* running one of the 040 binaries.
- and you are *NOT* using the latest 'setpatch'.
(it fixes a couple of bugs in 3.1. The symptoms are GURU 8..0B. If you get
them then you need SetMathPatch, probably. Read the docs of SetMathPatch)

How to use Ghostscript.
- Unpack the archive gs501data.lha to a suitable HD with enough room (~3.5M).
  for example 'Work:'.
  A directory 'Ghostscript' will be created and all files needed are found
  within this directory (Work:Ghostscript).
- Unpack one of the special binary archives to the same HD and the executable
  will automatically be placed in the same directory (Work:Ghostscript/gs_000).
  Further do:
  - Assign Ghostscript: Work:Ghostscript
  - path Ghostscript: add
    (Optionally, rename the binary gs_xxx to 'gs')
    Now you can call 'gs' from anywhere with or without arguments. If you add
    the above fragment (Assign ... add) to your s:user-startup then it will
    available everytime you start your computer
- Unpack gs501fonts-std.lha, if you don't have a set of good quality
  postscript fonts. The advantage of using this archive is that you don't
  need to mess with the file 'Fontmap'. The fonts will be placed in 
  'Work:Ghostscript/fonts'.
Or if you already have postscript fonts, do the following:
  - Assign PSFonts: to your postscript font directory (anywhere)
  - create file PSFonts:FONTMAP with at least the following entries:

% fontmap aka Fontmap
% ----------------------------------------------------------------
/Times-Roman                    (ptmr.gsf)      ;
/Times-Italic                   (ptmri.gsf)     ;
/Times-Bold                     (ptmb.gsf)      ;
/Times-BoldItalic               (ptmbi.gsf)     ;

    It does not matter, which font files are assigned (see below)

  - entries within the FONTMAP file at PSFonts: must follow the
    scheme described below:

          /Fontname             (Filename)      ;

    for example

          /Helvetica            (Helvet.pfb)    ;

    which means, the corresponding files must actually exist.
    But one also my substitute Fonts symbolically by other fonts,
    like for example:

          /Helvetica_Bold       /Helvetica      ;

  - the variables in ENV: and ENVARC: must look as follows:

      Variable          Content        Remark

      GS_FONTPATH                      do not set: delete this one!!
      GS_LIB            PSFonts:
      GS_OPTIONS                       set it, but keep it empty
      GS_DEVICE         amiga          for example (its the default)


See the 'Ghostscript/docs/use.txt' directory for more information, like
commandline options. Some notes:
- Watch out for case sensitivity when using commandline options, -sOutputFile
  is not equal to -soutputfile !!!!!
- Set your stack high enough, 32000 bytes should do it (stack 32000).

Some very useful commandlines with comments in ():
gs -h (outputs small help on most important arguments, and lists all availble
       output devices)
gs (gs opens window on WB and use its palette, use 256color WB if possible,
    there is a problem with NewIcons, it looks like all palette entries are
    reserved by NewIcons so GS will only display in B/W if you use NewIcons)
gs -sDEVICE=png16m (uses the built-in PNG support instead of window on WB)
gs -sOutputFile=ram:output%02d.png -sDEVICE=png256
   (output to files numbered ram:output01.png/ram:output02.png/etc using
    the PNG format (8bit))
gs -r120 (use 120dpi as resolution instead of built-in 72, uses heaps of
          memory at high values)
Arguments useful for PDF files (and ps documents conforming to DSC ?)
gs -dFirstPage=pagenumber (starts on the given page of the document)
gs -dLastPage=pagenumber (Stops after the given page of the document)
See use.doc/Switches for a complete overview of what is available.

(taken from 'new-user.txt')
PDF encryption
--------------

A user outside the U.S. has created code that allows processing of encrypted
PDF files.  Unfortunately, current U.S. export control laws don't allow
redistribution of this code from a site in the U.S., even though it's freely
available to anyone anywhere in the world from its author's site, so you'll
have to get this code from:

        http://www.ozemail.com.au/~geoffk/pdfencrypt/pdf_sec.ps

If that doesn't work, try:

        http://www.ozemail.com.au/%7Egeoffk/pdfencrypt/pdf_sec.ps

The patch consists entirely of PostScript code, so it can be added to a
running version of Ghostscript -- you don't have to recompile anything.  It
is a single file that replaces the file pdf_sec.ps in the standard
Ghostscript fileset (Ghostscript:data/pdf_sec.ps).

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[generic]                 7369   27617  26.7% -lh5- 9eb3 Jun 28  1996 Ghostscript/fonts/a010013l.afm
[generic]                25202   25994  97.0% -lh5- 0383 Jun 28  1996 Ghostscript/fonts/a010013l.pfb
[generic]                 3318    4679  70.9% -lh5- 3e01 Jun 28  1996 Ghostscript/fonts/a010013l.pfm
[generic]                 7221   27601  26.2% -lh5- 7fb1 Jun 28  1996 Ghostscript/fonts/a010015l.afm
[generic]                26193   26980  97.1% -lh5- 3632 Jun 28  1996 Ghostscript/fonts/a010015l.pfb
[generic]                 3294    4682  70.4% -lh5- b829 Jun 28  1996 Ghostscript/fonts/a010015l.pfm
[generic]                 7460   27756  26.9% -lh5- 7797 Jun 28  1996 Ghostscript/fonts/a010033l.afm
[generic]                26085   26882  97.0% -lh5- 39e5 Jun 28  1996 Ghostscript/fonts/a010033l.pfb
[generic]                 3315    4683  70.8% -lh5- fbd2 Jun 28  1996 Ghostscript/fonts/a010033l.pfm
[generic]                 7411   27796  26.7% -lh5- bbb1 Jun 28  1996 Ghostscript/fonts/a010035l.afm
[generic]                26736   27530  97.1% -lh5- abe2 Jun 28  1996 Ghostscript/fonts/a010035l.pfb
[generic]                 3281    4686  70.0% -lh5- 84e0 Jun 28  1996 Ghostscript/fonts/a010035l.pfm
[generic]                 7305   27608  26.5% -lh5- 31a3 Jun 28  1996 Ghostscript/fonts/b018012l.afm
[generic]                34774   35522  97.9% -lh5- 613e Jun 28  1996 Ghostscript/fonts/b018012l.pfb
[generic]                 3329    4681  71.1% -lh5- 0cf8 Jun 28  1996 Ghostscript/fonts/b018012l.pfm
[generic]                 7300   27432  26.6% -lh5- 3b5d Jun 28  1996 Ghostscript/fonts/b018015l.afm
[generic]                34708   35453  97.9% -lh5- 1d0d Jun 28  1996 Ghostscript/fonts/b018015l.pfb
[generic]                 3334    4685  71.2% -lh5- 24a5 Jun 28  1996 Ghostscript/fonts/b018015l.pfm
[generic]                 7459   27920  26.7% -lh5- 89df Jun 28  1996 Ghostscript/fonts/b018032l.afm
[generic]                33872   34617  97.8% -lh5- 0477 Jun 28  1996 Ghostscript/fonts/b018032l.pfb
[generic]                 3319    4685  70.8% -lh5- f723 Jun 28  1996 Ghostscript/fonts/b018032l.pfm
[generic]                 7461   27680  27.0% -lh5- e307 Jun 28  1996 Ghostscript/fonts/b018035l.afm
[generic]                34441   35218  97.8% -lh5- 9dfe Jun 28  1996 Ghostscript/fonts/b018035l.pfb
[generic]                 3328    4689  71.0% -lh5- e532 Jun 28  1996 Ghostscript/fonts/b018035l.pfm
[generic]                 7410   27576  26.9% -lh5- bfb8 Jun 28  1996 Ghostscript/fonts/c059013l.afm
[generic]                36813   37561  98.0% -lh5- c51e Jun 28  1996 Ghostscript/fonts/c059013l.pfb
[generic]                 3309    4665  70.9% -lh5- 9105 Jun 28  1996 Ghostscript/fonts/c059013l.pfm
[generic]                 7370   27510  26.8% -lh5- 0d26 Jun 28  1996 Ghostscript/fonts/c059016l.afm
[generic]                38014   38763  98.1% -lh5- 533d Jun 28  1996 Ghostscript/fonts/c059016l.pfb
[generic]                 3292    4665  70.6% -lh5- 365e Jun 28  1996 Ghostscript/fonts/c059016l.pfm
[generic]                 7529   27665  27.2% -lh5- 7fbf Jun 28  1996 Ghostscript/fonts/c059033l.afm
[generic]                37665   38413  98.1% -lh5- 79f9 Jun 28  1996 Ghostscript/fonts/c059033l.pfb
[generic]                 3315    4665  71.1% -lh5- d696 Jun 28  1996 Ghostscript/fonts/c059033l.pfm
[generic]                 7491   27665  27.1% -lh5- 470e Jun 28  1996 Ghostscript/fonts/c059036l.afm
[generic]                37992   38742  98.1% -lh5- 5dce Jun 28  1996 Ghostscript/fonts/c059036l.pfb
[generic]                 3306    4669  70.8% -lh5- b8e4 Jun 28  1996 Ghostscript/fonts/c059036l.pfm
[generic]                 2531    9294  27.2% -lh5- 258c Jun 28  1996 Ghostscript/fonts/d050000l.afm
[generic]                41798   44537  93.9% -lh5- f95c Jun 28  1996 Ghostscript/fonts/d050000l.pfb
[generic]                  446     674  66.2% -lh5- 9bd0 Jun 28  1996 Ghostscript/fonts/d050000l.pfm
[generic]                 7440   27644  26.9% -lh5- c748 Jun 28  1996 Ghostscript/fonts/n019003l.afm
[generic]                26714   27505  97.1% -lh5- 11fd Jun 28  1996 Ghostscript/fonts/n019003l.pfb
[generic]                 3268    4663  70.1% -lh5- f357 Jun 28  1996 Ghostscript/fonts/n019003l.pfm
[generic]                 7371   27557  26.7% -lh5- 5dcb Jun 28  1996 Ghostscript/fonts/n019004l.afm
[generic]                25981   26762  97.1% -lh5- 16c9 Jun 28  1996 Ghostscript/fonts/n019004l.pfb
[generic]                 3254    4679  69.5% -lh5- 97db Jun 28  1996 Ghostscript/fonts/n019004l.pfm
[generic]                 7563   28063  27.0% -lh5- 460c Jun 28  1996 Ghostscript/fonts/n019023l.afm
[generic]                27606   28397  97.2% -lh5- d6a9 Jun 28  1996 Ghostscript/fonts/n019023l.pfb
[generic]                 3321    4683  70.9% -lh5- 3468 Jun 28  1996 Ghostscript/fonts/n019023l.pfm
[generic]                 7486   27850  26.9% -lh5- 0f95 Jun 28  1996 Ghostscript/fonts/n019024l.afm
[generic]                28187   28971  97.3% -lh5- 50d5 Jun 28  1996 Ghostscript/fonts/n019024l.pfb
[generic]                 3295    4683  70.4% -lh5- ae98 Jun 28  1996 Ghostscript/fonts/n019024l.pfm
[generic]                 7267   27626  26.3% -lh5- 7f27 Jun 28  1996 Ghostscript/fonts/n019043l.afm
[generic]                26613   27406  97.1% -lh5- 2bac Jun 28  1996 Ghostscript/fonts/n019043l.pfb
[generic]                 3226    4686  68.8% -lh5- 5c83 Jun 28  1996 Ghostscript/fonts/n019043l.pfm
[generic]                 7209   27481  26.2% -lh5- 6497 Jun 28  1996 Ghostscript/fonts/n019044l.afm
[generic]                27175   27960  97.2% -lh5- 8c32 Jun 28  1996 Ghostscript/fonts/n019044l.pfb
[generic]                 3211    4686  68.5% -lh5- b45b Jun 28  1996 Ghostscript/fonts/n019044l.pfm
[generic]                 7409   27859  26.6% -lh5- 6624 Jun 28  1996 Ghostscript/fonts/n019063l.afm
[generic]                27494   28298  97.2% -lh5- cc83 Jun 28  1996 Ghostscript/fonts/n019063l.pfb
[generic]                 3281    4690  70.0% -lh5- 31ea Jun 28  1996 Ghostscript/fonts/n019063l.pfm
[generic]                 7411   27762  26.7% -lh5- 9f58 Jun 28  1996 Ghostscript/fonts/n019064l.afm
[generic]                28585   29384  97.3% -lh5- 4df6 Jun 28  1996 Ghostscript/fonts/n019064l.pfb
[generic]                 3260    4690  69.5% -lh5- 3245 Jun 28  1996 Ghostscript/fonts/n019064l.pfm
[generic]                 7471   27910  26.8% -lh5- d292 Jun 28  1996 Ghostscript/fonts/n021003l.afm
[generic]                34413   35161  97.9% -lh5- 1013 Jun 28  1996 Ghostscript/fonts/n021003l.pfb
[generic]                 3289    4685  70.2% -lh5- 2b21 Jun 28  1996 Ghostscript/fonts/n021003l.pfm
[generic]                 7497   27848  26.9% -lh5- b184 Jun 28  1996 Ghostscript/fonts/n021004l.afm
[generic]                34257   34996  97.9% -lh5- c079 Jun 28  1996 Ghostscript/fonts/n021004l.pfb
[generic]                 3310    4685  70.7% -lh5- 6cef Jun 28  1996 Ghostscript/fonts/n021004l.pfm
[generic]                 7552   27782  27.2% -lh5- 2a4f Jun 28  1996 Ghostscript/fonts/n021023l.afm
[generic]                36371   37139  97.9% -lh5- 5591 Jun 28  1996 Ghostscript/fonts/n021023l.pfb
[generic]                 3305    4673  70.7% -lh5- 3508 Jun 28  1996 Ghostscript/fonts/n021023l.pfm
[generic]                 7565   27855  27.2% -lh5- 50b7 Jun 28  1996 Ghostscript/fonts/n021024l.afm
[generic]                35572   36325  97.9% -lh5- c8db Jun 28  1996 Ghostscript/fonts/n021024l.pfb
[generic]                 3262    4673  69.8% -lh5- 0063 Jun 28  1996 Ghostscript/fonts/n021024l.pfm
[generic]                 2992   11261  26.6% -lh5- 1dde Jun 28  1996 Ghostscript/fonts/n022003l.afm
[generic]                34988   35719  98.0% -lh5- 834f Jun 28  1996 Ghostscript/fonts/n022003l.pfb
[generic]                  201     685  29.3% -lh5- f67f Jun 28  1996 Ghostscript/fonts/n022003l.pfm
[generic]                 3055   11265  27.1% -lh5- 719c Jun 28  1996 Ghostscript/fonts/n022004l.afm
[generic]                37547   38284  98.1% -lh5- 7d4e Jun 28  1996 Ghostscript/fonts/n022004l.pfb
[generic]                  203     685  29.6% -lh5- dcd8 Jun 28  1996 Ghostscript/fonts/n022004l.pfm
[generic]                 3202   11356  28.2% -lh5- 3b42 Jun 28  1996 Ghostscript/fonts/n022023l.afm
[generic]                33929   34677  97.8% -lh5- ab0b Jun 28  1996 Ghostscript/fonts/n022023l.pfb
[generic]                  206     689  29.9% -lh5- 8dcc Jun 28  1996 Ghostscript/fonts/n022023l.pfm
[generic]                 3216   11309  28.4% -lh5- 923f Jun 28  1996 Ghostscript/fonts/n022024l.afm
[generic]                39950   40686  98.2% -lh5- 039a Jun 28  1996 Ghostscript/fonts/n022024l.pfb
[generic]                  208     689  30.2% -lh5- 31ce Jun 28  1996 Ghostscript/fonts/n022024l.pfm
[generic]                 7528   27995  26.9% -lh5- f604 Jun 28  1996 Ghostscript/fonts/p052003l.afm
[generic]                41570   42328  98.2% -lh5- 1640 Jun 28  1996 Ghostscript/fonts/p052003l.pfb
[generic]                 3326    4683  71.0% -lh5- 3773 Jun 28  1996 Ghostscript/fonts/p052003l.pfm
[generic]                 7456   27753  26.9% -lh5- ca3e Jun 28  1996 Ghostscript/fonts/p052004l.afm
[generic]                40842   41591  98.2% -lh5- e21d Jun 28  1996 Ghostscript/fonts/p052004l.pfb
[generic]                 3297    4683  70.4% -lh5- 217c Jun 28  1996 Ghostscript/fonts/p052004l.pfm
[generic]                 7512   27921  26.9% -lh5- 986e Jun 28  1996 Ghostscript/fonts/p052023l.afm
[generic]                39162   39917  98.1% -lh5- d58d Jun 28  1996 Ghostscript/fonts/p052023l.pfb
[generic]                 3269    4683  69.8% -lh5- d0c8 Jun 28  1996 Ghostscript/fonts/p052023l.pfm
[generic]                 7488   27454  27.3% -lh5- edfe Jun 28  1996 Ghostscript/fonts/p052024l.afm
[generic]                39634   40387  98.1% -lh5- 17b6 Jun 28  1996 Ghostscript/fonts/p052024l.pfb
[generic]                 3335    4687  71.2% -lh5- ff30 Jun 28  1996 Ghostscript/fonts/p052024l.pfm
[generic]                 3294    9501  34.7% -lh5- 0ca9 Jun 28  1996 Ghostscript/fonts/s050000l.afm
[generic]                29034   32213  90.1% -lh5- f03a Jun 28  1996 Ghostscript/fonts/s050000l.pfb
[generic]                  400     682  58.7% -lh5- 8439 Jun 28  1996 Ghostscript/fonts/s050000l.pfm
[generic]                 7703   27737  27.8% -lh5- b8ce Jun 28  1996 Ghostscript/fonts/z003034l.afm
[generic]                37673   38422  98.1% -lh5- 65e0 Jun 28  1996 Ghostscript/fonts/z003034l.pfb
[generic]                 3356    4690  71.6% -lh5- e861 Jun 28  1996 Ghostscript/fonts/z003034l.pfm
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total       105 files 1498863 2206489  67.9%            Aug 26  1997