.NP
.EQ
delim $$
.EN
.ce
Notes on how to install
.br
.sp
.ce
"The CRC Graphics Package"
.br
.sp
.ce 4
Carl Crawford
School of Electrical Engineering
Purdue University
West Lafayette, IN  47901
.sp
.ce
Tel:~~317-494-3456
.sp
.ce 3
UUCP Address:~~VCBVAX!PUR-EE!CRC
~~~~~~~~~~~~~~~IHNP4!PUR-EE!CRC
~~~~~~~~~~~~~~~DECVAX!PUR-EE!CRC
.sp 2
.br
.ul
Introduction
.PP
This set of notes is to help new sites install
"the CRC graphics package"
on their systems.
The document first presents descriptions of the sources that are needed
to build the package.
Then how to compile and build the
package.
Finally,
how to configure the defaults to fit the system.
.sp
.ul
.ne 6
Sources
.PP
Create a source directory for the
graphics.
Currently the distribution tape
assumes that
.sp
.ce
/u/crc/graphics
.sp
is the root of the graphics system.
For the purpose of this paper,
.sp
.ce
$"~"~crc$
.sp
will indicate the root of the graphics source.
.PP
Within this directory,
these are the following sub-directories:
.sp
$"~"$crc/lib~~~~~~~~~~library subroutines
.br
$"~"$crc/src~~~~~~~~~~runtime programs
.br
$"~"$crc/charfont~~~~~character' font information
.br
$"~"$crc/doc~~~~~~~~~~nroff sources for documentation
.br
$"~"$crc/tmp~~~~~~~~~~junk directory.  (Ignore if present).
.sp
.PP
The library routines are subroutines
callable from either F77 or C.
Actual device control is done through pipes to programs in 
$"~"$crc/src.
The current drivers are:
.sp
$"~"$crc/src/gp.c~~~~~~Versatec electrostatic printer
.br
$"~"$crc/src/gp/p.c~~~~Printronix lineprinter
.br
$"~"$crc/src/hpd.c~~~~~HP Flatbed plotter
.br
$"~"$crc/src/gd.c~~~~~~Control/Grinnel image displays
.sp
The path names to the respective drivers are within 
the code.
Change them to reflect the configuration of your system.
'GPLP' pipes its output to 'OPR'.
If you don't have 'OPR',
just write directly to the printronix.
.sp 2
.ul
.ne 8
Installation First Time
.sp
.ul
.ti +5
Library Subroutines
.in +10
CD $"~"$crc/lib
.br
CC -c *.c
.br
AR CA /usr/lib/libG.a 'lorder*.c ltsort' (used to set up proper order
for a one-pass load.)
.sp
.in -10
.ne 8
Runtime
.br
.in +5
.br
CD~~$"~"$crc/src
.br
CC~~gplot.c~-i~-1G~-1m~-0\
.br
.ti +8
/u/bin/gplot
.br
.ti +12
*(note /u is the same as /usr)
.br
CC~~gp.c -0 /u/bin/gp
.br
CC~~gp/p.c -0 /u/bin/gp/p
.br
CC~~strip7.c -0 /u/bin/strip7
.br
mkdir~~/u/lib/graphics
.br
CC~~hpd.c -0 /u/lib/graphics/hpd
.br
CC~~gd.c -0 /u/lib(graphics)gd
.sp
.in -5
.ne 8
Charfont
.in +5
CD~~$"~"$crc/charfont
.br
CC~~genfont.c -0 genfont
.br
genfont /u/lib/graphics/font.5x7 \ < ifont.5x7
.br
(I just noticed that genfont.c is not up to date.
Just copy font.5x7 from the distribution tape).
.in -5
.sp
.PP
I realize that this is all very terse.
But if you look at the distribution tape,
and then at the 'makefiles',
it will be easy to figure out what I mean.
A note on the 'makefiles'.
At Purdue,
we run a network of machines.
The source for the network is on the 'A' machine
and all the other machines are updated from this
particular machine.
.PP
The first couple of lines in each section in each makefile is used
to update the local machine 
(A machine at Purdue).
The rest of each section gets the information
to other machines.
.sp 2
.ul
.ne 8
Documentation
.sp
.in +5
CD~~~~~$"~"$crc/doc
.br
mkdir~~/src/man/graphics/crc
.br
E~=~/src/man/graphics/crc
.br
for i in *.r
.br
DO
.br
~~~~~~~nroff S|i~>S|E/'basename~S|i'
.br
DONE
.in -5
.sp 2
.ul
.ne 8
Configuration
.PP
In /u/lib/graphics, there should
be four files:
.sp
.nf
                                     FORMAT
                      hpd.site       <machine name>
                      gd.site        <machine name>
                      gp.site        <machine name><size>
                      gplp.site      <-xx>
.fi
.sp
These files tell the respective programs where to send
the graphics output by default.
On the Purdue Network the
<machine name>
is one of the following:
.sp
.nf
.ne 8
                          local      $rarrow$ send output to local device
                          ve         Dual CPU VAX
                          vm         VAX
                          A          11/70
                          B          11/45
                          P          11/70
                          ARPA       11/45
.fi
.sp
If the <machine name> isn't local,
then the program 'ns'
is used to bring up a 'shell' on the
remote machine.
Set the <machine name> to the default machine.
If you do not have a network,
they should all be set to 'local'.
.PP
For gp/p.site the '-xx' specifies the default
network lineprinter.
.PP
For gp.site the <size> field is either 100 or 132.
This number is the size in 'words'
or 'bytes'
(I forget which one)
of the line length.
Most new  Versatecs are 100.
.sp 2
.ul
.ne 8
Update
.PP
All the 'makefiles'
are set up so that all the files are automatically
updated after changes are made.
This is useful on machines where
a network is used.
The program 'cs'
is just another version of the 'ns' routine,
but brings up a long shell.
.sp 2
.ul
.ne 8
Addition of New Network
.PP
This section is useful if you have
a set of machines that use the graphics package and a new one is added.
.PP
Get the following files from an existing machine.
.sp
.nf
.ne 6
                      /u/bin/gplot           
                            /gp              executable
                            /gplp
                            /strip7
.fi
.sp
.nf
.ne 6
           /u/lib/libG.a
                 /graphics/font.5x7
                          /gd
                          /hpd       executable
                          /gplp.site
                          /gp.site
                          /hpd.site
                          /gd.site
.fi
.sp
Then edit the *.site files to reflect the new machine.
.sp 2
.ul
Closing Remarks
.PP
If all the documentation/sources look confusing,
then I apologize.
The graphics package was originally written for my own use and
then released for general use.
I never expected the wide acceptance of the package.
Only in the past few months,
have changes been made to make it easy to 
use at other institutions.
This explains this handwritten document.
.PP
Please do not hesitate to call if you have problems.
.sp 4
.in +35
Carl Crawford
1 Oct.,  1981
.in -35
.sp 2
P.S.  Good luck and enjoy it once you get it working!
.bp
.BK 12
.ls 2
.nf
Computer File Information:
.in +10
Name of Paper:             "The CRC Graphics Package"
Author(s):                 Carl Crawford
Computer File Name:        CRCgraphic
Account Number:
Charges for this version:  2.0 hours
Done by:                   Jenny Owen
Date:                      Oct. 13, 1981
.in -10
.fi

