home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
rtsi.com
/
2014.01.www.rtsi.com.tar
/
www.rtsi.com
/
OS9
/
OSK
/
NETWORK
/
netpbm_docs.lzh
/
NETPBM
/
DOCS
/
README.VMS
< prev
next >
Wrap
Text File
|
1996-11-18
|
7KB
|
131 lines
25-FEB-1994
Hi VAX/VMS and future PBMplus users!!!
This version of Jef Poskanzer's PBMplus package is ready-made to
support the DEC VAX/VMS C 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.
"MAKEFILE.MMS"
-------------
There are two methods of building the executables. The first
(and prefered) method uses DECs "makefile" utility, MMS, 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
"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. Look through the procedure and edit it as
you see fit. 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.
"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. A logical name conflict or
something. Either logout and login to clear things out
or Deassign PBMplus_Root and PBMplus_Dir before using
MMS.
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:
PBMPLUS ---+ 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
_ _ _____ Senior Programmer Analyst O: 319/335--1879
| | | | |_ _| Department of Physics & Astronomy H: 319/338--6117
| | | | of | | Van Allen Hall NSI/DECnet: IOWASP::DYSON
| \_/ | _| |_ University of Iowa or : 7231::DYSON
\___/ |_____| Iowa City, IA 52242-1479