Extended Portable Bitmap Toolkit
                      Distribution of 22nov89
                   Previous distribution 13sep89
                      Modified for VMS 19jun90

[Tape Editor's note:
  This material arrived JUST before the tapes went out. By compressing
it and some executables elsewhere, I have been able to fit it onto
the Spring '90 tapes. Check out AAAREADME.1ST for a list of all the
(many!) formats this package converts between. Thanks to Ted Nieland
for sending this off his Amiga VMSnet node.
 -Glenn Everhart, tapecopy editor]

Included are a number of programs for converting various image formats
to and from portable formats; plus some tools for manipulating the
portable formats.  The package is broken up into four parts (five parts
if you count this one, the zeroth part).  First is PBM, for bitmaps (1
bit per pixel).  Then there is PGM, for grayscale images.  Next is PPM,
for full-color images.  Last, there is PNM, which does content-independent
manipulations on any of the three formats.

These parts are semi-independent; if you're only going to deal with
bitmaps, you don't have to install PGM and PPM, and this makes PNM run
faster; if you want PGM, you must install PBM but can leave PPM out;
but if you want PPM, you must install both PGM and PBM.  PNM is
optional but recommended.


To install:      (For VMS installation, see README.VMS)

    Unpack the files.
    Decide whether you want to use Imakefiles or Makefiles.  If you want
      to use Makefiles:

	Edit the top-level Makefile, find each line with the string
	  "CONFIGURE", and follow the directions for setting configuration
	  options.
	Likewise edit pbmplus.h.
	Likewise edit pnm/Makefile.
	Make.
	When you're happy that things work ok, make install.
    
    If you want to use Imakefiles instead:

	Edit the top-level Imakefile, find each line with the string
	  "CONFIGURE", and follow the directions for setting configuration
	  options.
	Likewise edit pbmplus.h.
	Likewise edit pnm/Imakefile.
	Edit Makefile and */Makefile, look towards the end for the
	  definition of TOP, and change it to point to your X11 tree.
	Save the original Makefiles, in case you later want to switch back
	  to using them.
	Touch Imakefile, since you just editted Makefile.
	Make Makefile, make Makefiles, make depend, then make.
	When you're happy that things work ok, make install.


I've tested this stuff under 4.2 BSD, 4.3 BSD, on Sun 3's 4's and 386's
and Sequents and Vaxen, with cc and gcc.  Nevertheless, I'm sure bugs
remain.  Feedback is welcome; send bug reports, enhancements, checks,
money orders, etc. to the addresses below.  Be sure to mention what
version you have when sending bug reports!

    Jef Poskanzer
    jef@well.sf.ca.us
    {ucbvax, lll-crg, sun!pacbell, apple, hplabs}!well!jef