Return to README CVS log

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

Annotation of researchv10no/cmd/PDP11/README, revision 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.