PIC 
                ---

This directory contains the sources, libraries and misc files for the PIC
program. The executable file PIC.EXE is included but image files for
programs that do the actaul plotting are not included because they access 
graphics that are under site liscence. You will need to create the .exe
files using the .obj files provided. Command procedures are included to
do so. Place the .exe files in PIC$BIN.
Before you can use the PIC program and the drivers, you'll
need to include the following commands in your login.com file and then rerun
the modified login.com:

	$ assign <pathname-to-PICBIN> pic$tables
	$ assign <pathname-to-PICBIN> pic$bin
	$ ddhp7221      :== $pic$bin:ddhp7221
	$ ddhp7475      :== $pic$bin:ddhp7475
	$ ddhp7550      :== $pic$bin:ddhp7550
	$ ddrgl     :== $pic$bin:ddrgl
	$ ddtek     :== $pic$bin:ddtek
	$ ddterm    :== $pic$bin:ddterm
	$ pic       :== $pic$bin:pic

where <pathname-to-PICBIN> is the complete directory pathname to the subdirect-
ory PICBIN, e.g, user$:[engr.group.pic.picbin]. Replace it with whatever holds
for your system. You choose to place the images in your public directory.

If you need to recreate PIC from it Modula-2 sources, you'll need the VMS
Modula-2 compiler. Here at UCCS, we use the Hamburg Compiler. I have not
tried to compile PIC using other Modula-2 compilers. The file "MAKEFILE.COM"
will do the entire job. If however, you donot have some of the graphics 
libraries which different device drivers need (the DD*.EXE) files, you may
have to comment out the lines that pertain to the missing library. Please
read the instructions in MAKEFILE.COM before proceeding.

This directory contains PIC.OBJ and the PIC library PICLIB.OLB. In case the
image PIC.EXE gets corrupted, you can use the command file "LINKPIC.COM" to
recreate the image from PIC.OBJ and PICLIB.OLB. Make sure to move to where
you had the older image.

Here's a short description of the files in this directory. Subdirectories
have their own AAAREADME.TXT files.


CMDLINEAR.DEF	Definition module for retrieving cmd line args
CMDLINEAR.MOD	the implementation module
CMDLINEAR.SYM	Symbol file generated by the compiler

F.F		contains a form feed

LEX.DEF		definition file -- Lexical analyser used by PIC
LEX.MOD		the implementation module
LEX.SYM		symbol file

LINKPIC.COM	cmd file to generate PIC.EXE from PIC.OBJ

MAKEFILE.COM	Makes PIC and device drivers from sources.

PIC.MOD		Main PIC module

PICADT.DEF	PIC abstract data types 
PICADT.MOD
PICADT.SYM

PICLIB.OLB	PIC library

PICPASSES.DEF	The recursive decent parser which parses PIC commands
PICPASSES.MOD
PICPASSES.SYM

PICBIN.DIR	Contains PIC.EXE, DDTERM.EXE and binary versions of the
		PIC's lexical analyser tables.

PLOT.DIR	SUBDIRECTORY-contains graphics related stuff used by PIC.
		Read the AAAREADME.TXT file for more info

SPLINE.DIR	SUBDIRECTORY-contains files which implement the cubic splines
		package. Read the AAAREADME.TXT file

TABLEMANA.DEF	PIC symbol table manager module
TABLEMANA.MOD
TABLEMANA.SYM

TABLES.DIR	SUBDIRECTORY-contains the tables used by the table driven
		lexical analyser. Read the AAAREADME.TXT file

TLEX.MOD	Just a test module to test out the lexical analyser

TOOLS.DEF	Tools used by PIC, e.g getc, putc, putstr etc
TOOLS.MOD
TOOLS.SYM

TY.COM		cmd file to print PIC sources

UDOC.DIR	SUBDIRECTORY-contains documentation and example programs
		
VMSRTL.DEF	Foreign definition module to access GET$FOREIGN system routine
VMSRTL.SYM

	
I would welcome suggestions or any problem with the program. PIC has a "-d"
option which turns on the internal debug flag. This causes PIC to trace out in
a verbose manner, the parsing of commands and actions taken. If you run into a
bug or bugs, specify the -d option after the "-e" option on the command line.
Capture the output and if possible, send it to me. 

	Sohail Aslam
	Dept. of Computer Science
	University of Colorado at Colorado Springs
	P.O.Box 7150
	Colorado Springs, CO 80933-7150

	Phone: (303) 593-3332