V10/cmd/PDP11/README

	    PDP11 utilities package for the VAX (Non-portable Parts)
		Release 3	13 may 1981	Steve Hartwell

Step 1:
To set this up, you need two tapes: this one, and the tape which has the
pdp11 c compiler, assembler, archiver, and various portable utilities.
Install the contents of that tape on top of the contents of this tape;
don't worry, no overlap occurs.  When you have done that, come back and
pick up at step 2.

Step 2:
Type "make init".  This will rename the files on the other tape to 11*.c,
which will be the naming convention of all pdp11 utilities on the VAX.
One directory included with the pdp11 tape called "crt" is untouched;
you may rm -r crt if you wish;  you may want to keep it if you are
building libraries and want to be sure of having the bug-free versions
of these all-important c interface routines.

Step 3:
If your system archiver (in /bin or /usr/bin) is the character format archiver
distributed with V7 systems, you don't need "car.c" (and probably not "carcv.c"
either).  USG version 4.0 systems still use the binary format archiver on the
VAX.  If this is true, you will have to use "car" instead of "ar" for making
libraries for 11ld to use. ("car" stands for "character format archiver").
If you do have the char format archiver, then you can get rid of these files.
Type "make rmcar" to remove the files, and it will also edit the Makefile
to no longer care about car.c, ar.h, carcv.c. (Do this instead of removing
the files yourself, please).

Step 4:
This tape contains the software directory for the floating-point preprocessor
"fpp" written by R. H. Hardin in 1202 B.C.  It is used for producing code
which does floating point arithmetic for PDP11/03's which don't have any
or have nonstandard floating point instructions that the 11 c compiler doesn't
know about.  If you have one of these beasties, you will need to use the
-F option in 11cc to get floating point stuff coded right.  It will use fpp
to massage your c text into subroutine calls using a special library fpp
supplies.  Chdir to fpp, and read the README before continuing to step 5.
If you only have LSI/23's or better, then you don't need fpp.  Type
"make rmfpp" which will get rid of the files, and also edit the Makefile.
As above, do not attempt to do this manually.

Step 5:
Edit the Makefile in this directory.  Change BINDIR = /where/you/want/it
and LIBDIR = /like/wise.  Optionally goto subdirectories 11as, 11c, fpp
and do the same.  This should be all that you have to do.  BINDIR and
LIBDIR should exist, and probably should ALREADY be in your PATH, since
make probably needs them.
To do everything, type:
make install
If you are cautious, type
make all
and then test things out in the current directory.  Once satisfied,
type:
make install

To clean up .o's, type "make clean"
To blast to the bare sources, type "make clobber"
To print all sources, type "make print" (warning--this is a lot)

Comments:
This makefile, and the ones in subdirectories, are ugly and complicated.
With exception to BINDIR and LIBDIR, they should be considered:
		"NO USER-SERVICABLE PARTS INSIDE!!"
They do, however, work reasonably well, and have been tested quite a bit.
DO NOT GOTO SUBDIRECTORIES to make stuff, like 11c or 11as, since the
parent Makefile (this one) carries down parameters different from the
defaults in the subdirectory Makefiles.  This is for portability reasons.
(You DO want to keep up-to-date, don't you?)
For those interested, the makefile conventions are:
make <object> such as make 11cc will make that one thing;
make inst<object> such as make inst11cc will make & install that one thing.

Have fun.  Problems with installing things, or with software on this tape,
should be forwarded to research!god.