/***************************************************************************
 * U. Minnesota LPD Software * Copyright 1987, 1988, Patrick Powell
 ***************************************************************************
 * MODULE: README
 * Comments about the use of the LPD software
 ***************************************************************************
 * Revision History: Created Fri Mar 11 14:31:45 CST 1988 Patrick Powell
 * $Log$
 ***************************************************************************/
This directory contains the source  of the PLP software.
This software is functionally  compatible with the 1983 Berkeley LPD software,
but with enhanced capabilites.  See  "PLP - Public Line Printer Spooler"
in the doc directory.

Directories:
RCS            bin            doc            filters        man
printcap       src            test

Files:
README

bin:	place to put binaries; cd bin; see Makefile
doc:	documentation- PLP - Public Line Printer Spooler Manual
filters:	basic set of filters
man:	man pages for lpr, etc.
printcap:	basic set of printcap entries.
src:	source files for the PLP software
test:	set of tests
RCS:	RCS files for src- may not be supplied with distribution.
imagen:	modified imagen support software- may not be supplied with distribution.
Transcript:	modified Transcript support software- may not be
        supplied with distribution.

Brief Installation Guide.

1.	make a ./bin directory, copy src/Makefile to ./bin.
2.	make a ./lint directory; this will be used by lint to put lint output

3.  bin/: Check out the Makefile,  and select the system you are compiling for.
The "IS_SUN" is for SUNs running UNIX 3.4 and up, the "IS_VAX" is for
BSD 4.3,  and the "IS_DATAGEN" is for Data Generals.  These flags are
used mainly to set some of the values of defines for lint and other
things;  there are some diablical differences in determining what is
an executable file.
	It is strongly suggested that you make a test version (XPERIMENT option
in Makefile).  This version uses /tmp/printcap and /tmp/printerperms
instead of /etc/printcap and /etc/printerperms.  In addition,  it does
NOT run SUID root.  It is a safe,  clean,  and sane way to debug this
stuff.  The remainder of this document assumes you try the test version
first.

4.  bin/: Pray for world peace and enlightenment.  While this probably won't
help with the next step,  it will give you a perspective on problems.  Do:

make clean
make test

You now have compiled everything.

5.  Read the test procedures in ./doc/PLP,  and try them out.
	The test directory has a set of files and printcaps that
	can be used for test purposes.

6.  backup/
Still feeling brave?  You should save the exisiting version of LPD;
the backup directory has a set of programs (shell scripts) to do this.
The lpr.save file contains a list of things to save and 
lpr.delete is a list of Berkelely things to delete.  Do:

cd ../backup
save.lpr

If you want to restore things quickly,  you can do:
cd ../backup
restore.lpr <date of save file>

and you are back to where you were before.

7.  Working verions: bin/Makefile
	comment out XPERIMENT flag, and do:
	make clean
	make all

8.  Setting up printcap and printer perms
	The /etc/printcap and other files have been moved to a new location:
	/usr/spool/lpd/printcap.<host> - printcap for <host>
	/usr/spool/lpd/printer_perms.<host> - printer perms for <host>
	/usr/spool/lpd/lpd.lock.<host> - lock file for <host>
	/usr/spool/lpd/log.<host> - log file for <host>
	
	If you are running an NFS environment, this allows you to share
	a common spool directory for all of the lpd daemons.  Note that
	the use of symbolic links from /usr/spool/lpd/printcap.<host>
	to the old /etc/printcap file can be used temporarily to get
	you going.

9.  After you have set up the printcap and other files,  you can try
	and installing the new version.
	make install

10.  And what is a system without documentation?  install the man pages by
hand.

11. You will probably find that your filters need fumbling with.
If you have problems with the Imagen stuff,  we have a version that is
ALMOST civilized.  The standard Imagen installation procedures are TOO
clever by half;  what we did was to rip out only the imprint,
ipr, and the communications stuff.
Contact us if you need these.  

12. Similarly we have a somewhat civilized version of the Adobe Transcript
software.  The existing version is (as far as we can tell) functionally
compatible with PLP.
