X-Git-Url: https://git.subgeniuskitty.com/unix-history/.git/blobdiff_plain/b7213e9c99f992750104bd3d65cc5ee64ba619b7..9f56c277b371ef22d937299a0a1106cfecf24741:/READ_ME diff --git a/READ_ME b/READ_ME index 203d45bc78..40f948df47 100644 --- a/READ_ME +++ b/READ_ME @@ -1,182 +1,19 @@ -.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 +Thu Apr 19 23:25:43 PST 1979 -lib Routines for /lib and /usr/lib -bin Routines for /usr/bin -etc Stuff for /etc -.DE -.TE -.SH -If you don't have floating point: -.LP -If you don't have floating point hardware, and wish to run Pascal, -you will need to add a system call to fetch an -instruction word when running separate I/D so that the floating -point interpreter can work. The system call to be added is "fetchi"... -if you can make it system call 61. (decimal) then the binaries on this tape -will work immediately. The code for "fetchi" will reside in sys4.c and -look like -.DS -fetchi() -{ - u.u_ar0[R0] = fuiword(u.u_ar0[R0]); -} -.DE -It is used as in: -.DS - mov $iaddr,r0 - sys fetchi -.DE -to get the contents of location "iaddr", a word in I-space. -Look at the floating point interpreter in the directory fpterp for a sample. -Don't forget that to make the system call work you must add an entry -to the sysent array in sysent.c. -.SH -Miscellaneous notes: -.LP -A version 7 C compiler and many of the binaries in "bin" are required -to make a new version of "pascal" or "ex". -For Pascal the file "nofloat" in this directory should exist... it -causes the scripts in the source directories to work slightly differently. -.SH -Feedback: -.LP -We would like to hear from all users of the Pascal system and of ex. -Reports of problems in bringing this software up, or of bugs in the -programs or documentation would be appreciated. We would also -appreciate hearing of any local improvements you make. -.SH -11/34 or 11/40 Pascal: -.LP -It is indeed unfortunate that the Pascal system here won't run on an 11/34 -or 11/40... the only reason this is true is that the translator "pi" -is too large. Pi used to be two pass but was made one pass about a year -ago. It is certainly possible to break pi into two passes or two processes -communicating through a pipe. If you have an 11/34 or 11/40 and are -interested in trying this I will be glad to give you more details. -.LP -.in +30 -Bill Joy -.br -CS Division -.br -Department of EE and CS -.br -UC Berkeley -.br -Berkeley, California 94704 -.sp -(415) 524-4510 [HOME] -(415) 642-4948 [SCHOOL] +For installation instructions: + + nroff -ms install.ms + +Subdirectories: + + bin Binaries for standard version 6 systems + + doc Source for documents + + man Source for manual pages + + misc A few miscellaneous files (see install.ms) + + src Source for programs/troff macros + + upgrade doc/man/src/include for version 6 systems