From 54711834646280a017ef1681ec6960abf4b51e99 Mon Sep 17 00:00:00 2001 From: Bill Joy Date: Tue, 31 Jan 1978 17:26:58 -0800 Subject: [PATCH] BSD 1 development Work on file READ_ME Synthesized-from: 1bsd --- READ_ME | 182 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 182 insertions(+) create mode 100644 READ_ME diff --git a/READ_ME b/READ_ME new file mode 100644 index 0000000000..203d45bc78 --- /dev/null +++ b/READ_ME @@ -0,0 +1,182 @@ +.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 + +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] -- 2.20.1