                                                              25-APR-1996

        This  is  NetPBM,  which  was  a  version of the original PBMPlus
    described  below  that  was  updated  and  added  to  by a world wide
    Internet based group  of  programmers  on  many different systems and
    then distributed world wide.   Everywhere  you  see  PBMPlus, you can
    safely substitute NetPBM...
    
Hi OpenVMS and future PBMplus users!!!

        This version of Jef Poskanzer's  PBMplus package is ready-made to
    support the Digital OpenVMS environment.  In  an  attempt  to make it
    run  like the Unix environment, the programs have  been  modified  to
    look  like they use the "piping" and "redirection" features  of  Unix
    and  MSDOS.    In  this  way,  the  documentation and other  people's
    comments (i.e., USENET alt.graphics.pixutils  discussions, etc.) will
    be the same for all platforms.

        This  VMS  implementation  borrows  heavily  from  the  previous
    PBMplus/VMS release  by  Rick Dyson for 10dec91 which in turn builds
    on the work  Terry  Poot (tp@mccall.com) did for the 05feb91 general
    release of PBMplus.   Many thanks and credits go his direction.  The
    "piping/redirection"    is    attributed    to    Mark     Pizzolato
    (mark@infopiz.uucp).  The creation of the  shareable  library is due
    to work done by Dave Jones (JONESD@kcgl1.eng.ohio-state.edu).

        Well,  since  you  are reading this, I guess you have the PBMplus
    kit and have broken it out into it's respective directories.  At this
    point you just have to start the build operation.  In this release of
    the PBMplus package  the  process  is  much  easier than in the past.
    There is no patching  of the source code necessary and so there is no
    extra "patch-build kit".  This  contains everything you need to build
    the PBMplus package.
    
        There is only one step to the preparation process and that is to
    copy  all the files from the [.VMS] sub-directory up one level  into
    the  root  [PBMplus]  directory.

                    WARNING! WARNING! WARNING! WARNING!

        You should  not  work on PBMplus in a directory structure that is
    under a rooted-logical  name  as  it  will interfer with the way this
    package works because *it*  uses a rooted logical name.  If your work
    area is a sub-directory under a concealed rooted logical name, change
    your default to the same place  but  spell  out the full device name.
    If  you don't understand this, I suggest  you  consult  with  someone
    about what to do before trying to build PBMplus on VMS.

"MAKEFILE.MMS"
-------------
        There  are two methods of building the executables.    The  first
    (and  prefered) method uses DECs "makefile" utility, MMS (or  the  PD
    MMK  by  MadGoat Software), which uses the "MAKEFILE.MMS" files.   If
    you  don't  have  MMS, skip to the section labeled "MAKE_PBMPLUS.COM"
    below.   If  you  are  still  with  me, just type "MMS /Description =
    Makefile.MMS" and follow the directions outlined on the screen.  Your
    most probable sequence will be the something like the following:

$ MMS /Description = Makefile.MMS ALL
$ MMS /Description = Makefile.MMS INSTALL   ! creates & loads [.Exe]
$ MMS /Description = Makefile.MMS HELP      ! make PBMPLUS.HLB
$ MMS /Description = Makefile.MMS MANUAL    ! will need LaTeX and tr2TeX...
$ MMS /Description = Makefile.MMS INSTALLMANUAL ! creates & loads [.TeX]
$ MMS /Description = Makefile.MMS CLEAN     ! clean up all recoverable files

        The  available  choices  will  be  displayed  if you  don't  say
    anything, i.e.

            $ MMS /Description = Makefile.MMS

    Alpha and DEC C users should include the command line qualifier
    /Macro = "Alpha=1" to the above command.

"MAKE_PBMPLUS.COM"
------------------
        The other method of  building  the  package  is  to  execute  the
    "MAKE_PBMPLUS.COM" command procedure.  This was mostly created by the
    "MMS BUILD_PROC" command.  It is  not  as flexible as MMS, but should
    get the job done.  You *MUST*  look through the procedure and edit it
    as you see fit before you can start the build routine.  You will need
    to comment out a couple lines at the top  right  away.  It builds and
    installs just about everything, so it might be in your  best interest
    to  look  through  it  and  use your veto powers to comment  out  the
    unneeded (or unavailable) parts.  Be sure to look and check what  you
    have before executing the procedure.

        I would love to have someone submit a nice, clean version of this
    command proc that  would make future updates easy.  Would anyone like
    to write it and pass it along to me for future integration?

"SETUP.COM"
-----------
        I  have  provided two  setup  files  with  this  distribution  to
    facilitate the day-to-day use of  PBMplus.    All  you  need to do is
    execute the SETUP.COM command procedure and  it  will  make  all  the
    logical name and foreign symbol definitions.  You should look through
    SETUP.COM and read the comments about the rooted  logical names used.
    After  all  that, look through the TeX documentation or  the  on-line
    help files to get an idea of how to start using PBMplus.
    
        NOTE:    An  error  in  MMS will occur if you  have  used
        SETUP.COM *before*  using  MMS.    Do  NOT  do  this!!  A
        logical name conflict  or  something.   Either logout and
        login to clear things  out  or  Deassign PBMplus_Root and
        PBMplus_Dir before using MMS.   See  the warning above as
        well.
    
Manifest
--------
        The following files are included  with this VMS port of PBMplus.
    The bare essential ones needed to complete the build are marked with
    an astreisk (*):

        [.VMS]MAKEFILE.MMS     -- VMS MMS description file (i.e., "makefile")
                                  for all of PBMplus
       *[.VMS]MAKE_PBMPLUS.COM -- VMS command procedure produced by MMS to build
                                  the PBMplus package for users without MMS
       *[.VMS]MAKE_PBMPLUSSHR.COM -- VMS command procedure to build Shareable
                                  link library of the four main PBMplus object
                                  libraries; LIBPBM, LIBPGM, LIBPPM, & LIBPNM
        [.VMS]SETUP.COM        -- An initialization/definition command proc for
                                  "everyday use" of PBMplus once it's built
        [.VMS]ADD_LIST.COM     -- Generic command procedure to add another
                                  library to any VMS librarian list, (i.e.,
                                  Hlp$Library_nn or Lnk$Library_nn)
        [.VMS]PBMPLUS.HLP      -- VMS Help library file for all of PBMplus
        [.PBM]MAKEFILE.MMS     -- VMS MMS description file for PBM routines
        [.PGM]MAKEFILE.MMS     -- VMS MMS description file for PGM routines
        [.PPM]MAKEFILE.MMS     -- VMS MMS description file for PPM routines
        [.PNM]MAKEFILE.MMS     -- VMS MMS description file for PNM routines
        [.LIBTIFF]MAKEFILE.MMS -- VMS MMS description file for LIBTIFF routines

        When it's all over and done, the PBMplus directory tree should
    resemble  the  following  (note  the  root  directory  name  will  be
    different):

    PBMPLUS  ---+ Amiga                         <-- AmigaDOS files
                |
                + EXE                           <-- the binaries
                |
                + LIBTIFF                       <-- TIFF library
                |
                + PBM                           <-- Portable BitMaps
                |
                + PGM                           <-- Portable Grayscale Maps
                |
                + PNM                           <-- Portable aNy Maps
                |
                + PPM                           <-- Portable Picture Maps
                |
                + VMS                           <-- VMS specific files

Rick Dyson
--
Richard L. Dyson               INTERNET:  Dyson@IowaSP.Physics.UIowa.EDU
                            URL: http://www-pi.physics.uiowa.edu/~dyson/
 _   _      _____    Senior Programmer Analyst           O: 319/335-1879
| | | |    |_   _|   Department of Physics & Astronomy   H: 319/338-6117
| | | | of   | |     Van Allen Hall                    FAX: 319/335-1753
| \_/ |     _| |_    University of Iowa        NSI/DECnet: IOWASP::DYSON 
 \___/     |_____|   Iowa City, IA 52242-1479         or :   7231::DYSON 
