
    PEN filters:  programs to display VPLOT files

To make a new set of executables,

    - Link  ./include/vplot.h to /usr/include/vplot.h

    - Edit  ./machdep to reflect the configuration you desire:
        BIN directory:
	    Where to put the executables.
        OWNER, GROUP: parameters for "install"
        CFLAGS: Link for debugging?  Where are the include files?
            Note that CFLAGS will be exported to the subdirectories
            when make is run there.

    - Edit ./machdep_restrict to indicate pen filters that should
	only be runnable by people in a certain group.
	Normally all pen filters are owned by "OWNER" and in group
	"GROUP" (as set in machdep) with everybody having execute
	permission.
	Each line of machdep_restrict has the format:
	pen_filter_name	group_name
	Pen filter "pen_filter_name" will be executable only by
	people in group "group_name". If machdep_restrict doesn't
	exist, all pen filters will be installed with the default
	permissions.

    - Move subdirectories for pen libraries you don't need (does
        your installation have a Raster Technologies display?) to
        ./otherpens.  This will prevent MakeMake from adding those
        libraries to the Makefile.
	(If you don't HAVE any pen libraries at all, don't panic,
	they are also being distributed by the same channels as
	this "Vplot Kernel" package. For example, if you want a
	pen filter for an Envision, you simply get the "Envision_device"
	distribution. In this distribution will be a directory "envilib".
	Move that directory into this one, and you're ready to go to
	the next step.)

    - Remove MakeMakesep if you don't have SEPlib on your machine.
	If you do have SEPlib edit machdepsep like you edited
	machdep. (See comment on SEPlib at the bottom of this file.)

    - Edit ./hosttype to give your machine type

    - Check the entries in ./include/params.h to be sure the default
        parameters are correct for your system.
		The default STYLE is usually STANDARD or ROTATED.
		The traditional default vplot font is 0; Some prefer 1,
		the Hershey Roman simplex font.

    - Do
        csh MakeMake
            and a Makefile will be generated, based on makefile
            fragments (*makef files) taken from each device subdirectory.
	    (If you have written a new device, you should also create
	    a makef file for it, following one of the ones for another
	    device as an example.)

        Comment out install lines for files which won't be installed.

        Check the group and owner entries on the install lines.
            If your users don't have write access in the spooling
            directory, ipen and pspen must be setuid or setgid
            (and the owner or group must have the appropriate
            access).

    - Do
	Either get the Hershey fonts and install them as described in
	man vplottext, or edit ./include/font_definitions.h so that you
	only try to compile the provided pen font into gentext.c.
	(You can leave the other fonts to be loaded at runtime; if you
	try to use them you'll only get a warning. That way if you later
	get the Hershey fonts you can slip them in without having to recompile
	anything.) Don't forget to do "make" in the directory
	./include/vplotfonts to install all the required fonts in the required
	formats.

    - Do 
        make >& Makelog &
            and then
        make install
            and the programs should be usable. (Good luck! If they're not,
	    I suppose you have to look in Makelog and figure out what
	    happened...)

Remember to also install copies of plas and pldb (they are in ../util).
You'll need them to try out most of the tests (in ./Tests).

If the number of vplot filters on your system grows large, I recommend
creating a shell to pick the correct pen filter for the user. We call
ours ``tube''. An example copy of it is in ../util. Since you won't have
the same terminals, yours will have to be different.

The mysterious references to "SEP" in ifdef's throughout the code
and in the Makefiles can be safely ignored if you don't know what SEPlib
is and don't have the -lsep library. This code is designed to run either
under SEP-lib or outside of it. (SEPlib is a seismic data-processing
system invented by Stew Levin and Jon Claerbout that we use in the
Stanford Exploration Project in the Geophysics Department at
Stanford University.)
I didn't want to create a different version of the source code just
for this distribution. We use both the SEP and non-SEP versions of the code
at Stanford.

                                        Written by Chuck Karish
                                        January 8, 1987
					Modified by Joe Dellinger
                                        June 2, 1987
