Return to README CVS log

Up to [Research Unix] / researchv10no / cmd / PDP11

Annotation of researchv10no/cmd/PDP11/README, revision 1.1.1.1

1.1       root        1:            PDP11 utilities package for the VAX (Non-portable Parts)
                      2:                Release 3       13 may 1981     Steve Hartwell
                      3: 
                      4: Step 1:
                      5: To set this up, you need two tapes: this one, and the tape which has the
                      6: pdp11 c compiler, assembler, archiver, and various portable utilities.
                      7: Install the contents of that tape on top of the contents of this tape;
                      8: don't worry, no overlap occurs.  When you have done that, come back and
                      9: pick up at step 2.
                     10: 
                     11: Step 2:
                     12: Type "make init".  This will rename the files on the other tape to 11*.c,
                     13: which will be the naming convention of all pdp11 utilities on the VAX.
                     14: One directory included with the pdp11 tape called "crt" is untouched;
                     15: you may rm -r crt if you wish;  you may want to keep it if you are
                     16: building libraries and want to be sure of having the bug-free versions
                     17: of these all-important c interface routines.
                     18: 
                     19: Step 3:
                     20: If your system archiver (in /bin or /usr/bin) is the character format archiver
                     21: distributed with V7 systems, you don't need "car.c" (and probably not "carcv.c"
                     22: either).  USG version 4.0 systems still use the binary format archiver on the
                     23: VAX.  If this is true, you will have to use "car" instead of "ar" for making
                     24: libraries for 11ld to use. ("car" stands for "character format archiver").
                     25: If you do have the char format archiver, then you can get rid of these files.
                     26: Type "make rmcar" to remove the files, and it will also edit the Makefile
                     27: to no longer care about car.c, ar.h, carcv.c. (Do this instead of removing
                     28: the files yourself, please).
                     29: 
                     30: Step 4:
                     31: This tape contains the software directory for the floating-point preprocessor
                     32: "fpp" written by R. H. Hardin in 1202 B.C.  It is used for producing code
                     33: which does floating point arithmetic for PDP11/03's which don't have any
                     34: or have nonstandard floating point instructions that the 11 c compiler doesn't
                     35: know about.  If you have one of these beasties, you will need to use the
                     36: -F option in 11cc to get floating point stuff coded right.  It will use fpp
                     37: to massage your c text into subroutine calls using a special library fpp
                     38: supplies.  Chdir to fpp, and read the README before continuing to step 5.
                     39: If you only have LSI/23's or better, then you don't need fpp.  Type
                     40: "make rmfpp" which will get rid of the files, and also edit the Makefile.
                     41: As above, do not attempt to do this manually.
                     42: 
                     43: Step 5:
                     44: Edit the Makefile in this directory.  Change BINDIR = /where/you/want/it
                     45: and LIBDIR = /like/wise.  Optionally goto subdirectories 11as, 11c, fpp
                     46: and do the same.  This should be all that you have to do.  BINDIR and
                     47: LIBDIR should exist, and probably should ALREADY be in your PATH, since
                     48: make probably needs them.
                     49: To do everything, type:
                     50: make install
                     51: If you are cautious, type
                     52: make all
                     53: and then test things out in the current directory.  Once satisfied,
                     54: type:
                     55: make install
                     56: 
                     57: To clean up .o's, type "make clean"
                     58: To blast to the bare sources, type "make clobber"
                     59: To print all sources, type "make print" (warning--this is a lot)
                     60: 
                     61: Comments:
                     62: This makefile, and the ones in subdirectories, are ugly and complicated.
                     63: With exception to BINDIR and LIBDIR, they should be considered:
                     64:                "NO USER-SERVICABLE PARTS INSIDE!!"
                     65: They do, however, work reasonably well, and have been tested quite a bit.
                     66: DO NOT GOTO SUBDIRECTORIES to make stuff, like 11c or 11as, since the
                     67: parent Makefile (this one) carries down parameters different from the
                     68: defaults in the subdirectory Makefiles.  This is for portability reasons.
                     69: (You DO want to keep up-to-date, don't you?)
                     70: For those interested, the makefile conventions are:
                     71: make <object> such as make 11cc will make that one thing;
                     72: make inst<object> such as make inst11cc will make & install that one thing.
                     73: 
                     74: Have fun.  Problems with installing things, or with software on this tape,
                     75: should be forwarded to research!god.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.