-.ND
-.ce
-Berkeley UNIX Software Tape
-.sp 3
-.SH
-Extracting the data from this tape:
-.LP
-Most of the data on this tape has been archived to reduce the number
-of files so that tp will write this tape. You should extract
-the data from the libraries. This will require about 10000 blocks
-of storage if you don't remove each "cont.a" after you extract it.
-.SH
-What is on this tape:
-.LP
-This tape includes sources and binaries for a quantity of UC
-Berkeley software. The major items on this tape are the instructional Pascal
-system and the text editor "ex". Other software here includes a modified shell,
-a new shell, new commands, and a "star trek" game.
-Machine readable documentation is included for all programs.
-The "Pascal User's Manual" and the "Ex reference manual" need a
-phototypesetter if readable copies are to be produced.
-.SH
-Pascal:
-.LP
-The Pascal system has been used for a year for instruction here.
-It has undergone a number of improvements in the last six months,
-but is quite stable. We use it for undergraduate and graduate instruction.
-.LP
-The Pascal system requires separate I/D space; that
-is, an 11/45 or 11/70 host. To run the Pascal stuff right away
-you will also need floating point hardware -- it is possible
-to run Pascal without floating point hardware but it requires
-adding a system call to replace the "mfpi" instruction that doesn't
-work on the 11/45's and 11/70's in user mode.
-.SH
-Ex:
-.LP
-The Ex editor has been in use for about the same length of time as Pascal,
-and is used by a majority of our users. It has undergone a number of
-improvements in the last few months. We intend to use ex for the
-text editing classes at the Computer Center here (for a general campus
-audience) starting in January. The Pascal documentation uses "ex"
-in its examples.
-.SH
-Installing the software:
-.LP
-Compiled binaries have been included for most of the software here.
-(A few of the routines in the directory s6 include system dependent headers
-and so binaries would be of no use and are not included.)
-.LP
-The major programs "pi", "pxp", "px", and "ex-1.1" have the binaries in
-the directories with the same names. "Pi", "pxp" and "px" should
-run as they stand... if you have a non-standard teletype driver "ex" may
-require some system dependent changes. The binaries in "ex" will run
-directly on standard or Berkeley-type version 6 UNIX systems.
-.LP
-Each major directory includes a file "READ_ME" describing the software
-in the directory. There is often a shell script "setup" in the directory
-to perform one time only operations. The script "install" in these
-directories will place the software in its standard home.
-.LP
-For recompilation of these programs you can use the scripts "make*",
-and "comp" and "load" in the directories. Most directories also
-have "print" scripts, i.e. "printpi", to make a program listing
-with utility files and programs in a reasonable order.
-.LP
-The suggested way to bring up the software on this tape is to
-run the install scripts in "pi", "pxp", and "px", and to then
-install (some or all) of the software from "bin".
-The editor "ex" can also be installed... this requires probably as
-much work as all the others combined as it uses some data bases
-which don't exist on standard UNIX relating to terminal types and
-capabilities.
-.LP
-Note that some of the scripts to make new versions of the software
-on this tape use the programs in "bin".
-You can run these scripts easily, without adding all the stuff in "bin"
-to your "/usr/bin", by using the shell in "ashell".
-This shell has a number of nice features and was used in making all
-the software here... the files "errs" in each of the major directories
-are outputs from the "make*" scripts so you can see how this was done.
-Documentation for "ashell" is in s6/sh.6.
-.LP
-The trek game in "trek" uses the rewritten portable library in "portlib".
-It (and the program tset) were written by Eric Allman whose address
-is in the trek setup instructions in "trek".
-.br
-.ne 30
-.SH
-Directory contents:
-.LP
-.DS
-.TS
-lw(10) l.
-pi Pascal translator source
-px Pascal interpreter
-pxp Pascal execution profiler
-eyacc Modified yacc for Pascal
-assubs Assembly stuff for Pascal
-tests Test programs for Pascal
-pcs Wirth's Pascal-S
-pxref Pascal cross-refence program
-opcodes Definition files for Pascal
-fpterp Sep ID floating point interpreter using FETCHI sys call
-s? Command software source
-man? Documents for s? stuff
-ashell A new shell with some nice features
-ex-1.1 Ex source
-exrecover Ex recovery routines (after system crashes)
-trek Source for a "star trek" game
-portlib Portable library used by trek
-exrefm Troff source for "Ex 1.1 Reference Manual"
-puman Troff source for "UNIX Pascal User's Manual"
-help Sections from our help command