'\" To get a copy of this PWB/UNIX DOCUMENT TABLE OF CONTENTS on your terminal, type: '\" nroff -mm documents '\" '\" To get a typeset copy, type: '\" troff -mm documents '\" .de a .br .ne 6 .nr c +1\"" .LI \\*b.\\nc .. .de e .if n \\$1~~~\\$2 .if t .ss 18 .if t .I "\s+1\\$1\s-1" "~~\\$2" .if t .ss 12 .br .. .de p .if !\\n(.$-1 \\$1 .if \\n(.$-1 \\$1~~~(p.~\\$2) .br .. .de x .ti -3n ====== .br .. .PH "''''" .nh .rm hy .hw print-out photo-type-setter .tr ~ .if n .po +5n .if n .na .if n .rm ad .ds C \fB\s-1C\s+1\fP .if t .ds ` ``\" .if t .ds ' ''\" .if t .ds d \(em\" .if n .ds ` ""\" .if n .ds ' ""\" .if n .ds d " -- \" .br .if t .ss 18 .rs .if t .sp |2.5i .if t .ps 36 .if t .ce .if t \(bs .if t .ps .sp |4.2i .ps 20 .ft B .ce 3 Documents for the P\s-4WB/UNIX\s+4 .sp 2v Time-Sharing System .sp 2v .ft .ps 14 .if t .ft I Edition 1.0 .sp 3v .ps 12 .vs 14p .if t .ft .in +\n(.lu-\w'E. M. Piskorik'u/2u\" T. A. Dolotta .br R. C. Haight .br E. M. Piskorik .in -\n(.lu-\w'E. M. Piskorik'u/2u\" .vs 12p .sp 1v .if t .ft I .ce 2 Editors .sp 2v August 1977 .br .ps 10 .if t .ft .sp 5v .if t .ll -1.6i .if t .in +1.6i The enclosed \s-2PWB/UNIX\s+2 documentation is supplied in accordance with the Software Agreement you have with the Western Electric Company. .if t .in -1.6i .if t .ll .sp \n(.tu-1v .ce Bell Telephone Laboratories, Incorporated .br .ss 12 .rs .sp |3i .ce UNIX is a Trademark/Service Mark of the Bell System. .sp |7.5i .if t .ll -1.45i .if t .in +1.45i .if t .ft I The enclosed documents were set on a Graphic Systems, Inc. phototypesetter driven by the \s-2TROFF\s+2 formatting program. Their text was prepared using the \s-2ED\s+2 text editor. .bp .if t .ft .if t .ll .if t .in -1.45i .ce .B CONTENTS .if n .sp .if t .sp .5v Each item below carries the date of its latest revision; most items also give the number of their last page. .nr P 1 .PF "''- \\\\nP -''" .PH "''- \\\\nP -''" .VL 4 .nr c 0\" .ds b G\" .ne 10 .B .LI "G." General: .R .VL 6 .a .e "P\s-2WB/UNIX\s+2\*dOverview and Synopsis of Facilities" "(6/77)" .p "T. A. Dolotta and R. C. Haight" 18 Summarizes the salient features of Programmer's Workbench\s-2/UNIX\s+2, a program development and text processing facility. .a .e "The U\s-2NIX\s+2 Time-Sharing System" "(7/74)" .p "D. M. Ritchie and K. Thompson" 16 Reprinted from \fIComm. \s-2ACM\s+2.\fP Good overview of \s-2UNIX\s+2, but written long ago. .a .e "The U\s-2NIX\s+2 Time-sharing System\*dA Retrospective" "(1/77)" .p "D. M. Ritchie" 14 A more recent discussion. .a .e "P\s-2WB\s+2 Papers from the Second International Conf. on Software Engineering" "(10/76)" .p "T. A. Dolotta \fIet al.\fP" 25 Reprinted from that conference's proceedings. Four papers that describe various aspects of the \s-2PWB\s+2. .LE 1 .nr c 0-1\" .ds b B\" .ne 10 .B .LI "B." Basic User Information: .R .VL 6 .a .e "P\s-2WB/UNIX\s+2 User's Manual\*dEdition 1.0" "(5/77)" .p "T. A. Dolotta, R. C. Haight, and E. M. Piskorik, eds." Describes all commands, subroutines, and system calls. Furnished as a separate volume. Available \%on-line. .a .e "P\s-2WB/UNIX\s+2 Documentation Roadmap" "(5/77)" .p "J. R. Mashey" 7 A terse, up-to-date outline of useful documents and information sources. Available \%on-line. .a .e "P\s-2WB/UNIX\s+2 Beginner's Course" "(11/77)" .p "M. E. Pearlman and S. H. Strauss" An outline with view graphs. .a .e "A Tutorial Introduction to the U\s-2NIX\s+2 Text Editor" "(10/74)" .p "B. W. Kernighan" 10 Expectedly elementary, but very useful for beginners. .a .e "Advanced Editing on U\s-2NIX\s+2" "(8/76)" .p "B. W. Kernighan" 16 Meant to help secretaries, typists, and programmers make effective use of \s-2UNIX\s+2 facilities for preparing and editing text. .a .e "P\s-2WB/UNIX\s+2 Shell Tutorial" "(9/77)" .p "J. R. Mashey" 25 Describes the \s-2PWB/UNIX\s+2 command interpreter. .a .e "U\s-2NIX\s+2 for Beginners" "(10/74)" .p "B. W. Kernighan" 14 A slightly dated tutorial. .a .e "U\s-2NIX\s+2 Programming" "(10/75)" .p "B. W. Kernighan and D. M. Ritchie" 17 Introduction to programming on \s-2UNIX\s+2. The emphasis is on how to write programs that interface with the operating system. Does .I not cover material in .I "A New Input/Output Package" (item B.10 below). .a .e "\*C Reference Manual" "(5/77)" .p "D. M. Ritchie" 32 Terse, but complete. .a .e "Programming in \*C\*dA Tutorial" "(5/75)" .p "B. W. Kernighan" 27 Should be read before tackling the .I "\*C Reference Manual" (item B.8 above). .a .e "A New Input-Output Package" "(7/77)" .p "D. M. Ritchie" 6 Should be used for all new \*C programs. .a .e "A General-Purpose Subroutine Library for P\s-2WB/UNIX\s+2" "(7/77)" .p "A. L. Glasser" 7 Complements .I "A New Input/Output Package" (item B.10 above). .a .e "Guide to \s-2IBM\s+2 Remote Job Entry for P\s-2WB/UNIX\s+2 Users" "(9/77)" .p "A. L. Sabsevitz" 7 Describes the \s-2RJE\s+2 facility between a \s-2PWB\s+2 system and an \s-2IBM\s+2 System/370. .a .e "S\s-2CCS/PWB\s+2 User's Manual" "(9/77)" .p "L. E. Bonanni and A. L. Glasser" Describes the Programmer's Workbench Source Code Control System. .LE 1 .PF "''''" .nr c 0\" .ds b T\" .ne 10 .B .LI "T." Text Processing, Formatting, and Typesetting: .R .VL 6 .a .e "N\s-2ROFF/TROFF\s+2 User's Manual" "(5/77)" .p "J. F. Ossanna" 34 N\s-2ROFF\s+2 and \s-2TROFF\s+2 are text processors. N\s-2ROFF\s+2 formats text for a variety of typewriter-like terminals. T\s-2ROFF\s+2 formats text for a Graphic Systems, Inc. phototypesetter. .a .e "P\s-2WB/MM\s+2\*dProgrammer's Workbench Memorandum Macros" "(9/77)" .p "D. W. Smith and J. R. Mashey" User's guide and reference manual for \s-2PWB/MM\s+2, a general-purpose package of text formatting macros for use with \s-2NROFF\s+2 and \s-2TROFF\s+2. .a .e "Typing Documents with P\s-2WB/MM\s+2" "(9/77)" .p "D. W. Smith and E. M. Piskorik" 16 A fold-out card that fits into a pocket(book). .a .e "P\s-2WB/MM\s+2 Tutorial" "(12/77)" .p "N. W. Smith" In preparation .a .e "Tbl\*dA Program to Format Tables" "(9/77)" .p "M. E. Lesk" 17 Preprocessor for \s-2TROFF\s+2 or \s-2NROFF\s+2 that makes even very complex tables easy to specify. .a .e "A T\s-2ROFF\s+2 Tutorial" "(8/76)" .p "B. W. Kernighan" 13 Introduction to the most basic use of \s-2TROFF\s+2 (and, by implication, \s-2NROFF\s+2). .a .e "Typesetting Mathematics\*dUser's Guide (Second Edition)" "(6/76)" .p "B. W. Kernighan and L. L. Cherry" 11 Describes the \s-2EQN\s+2 and \s-2NEQN\s+2 preprocessors for \s-2TROFF\s+2 and \s-2NROFF\s+2, respectively. They allow one to typeset complex formulae, equations, arrays, etc., both in-line and displayed. .a .e "New Graphic Symbols for E\s-2QN\s+2 and N\s-2EQN\s+2" "(9/76)" .p "C. Scrocca" 8 Defines a set of special characters frequently used in technical documents. Shows how to use them and discusses what is involved in making a special character in \s-2NROFF\s+2 and \s-2TROFF\s+2. .a .e "P\s-2WB/UNIX\s+2 View Graph and Slide Macros" "(12/77)" .p "T. A. Dolotta and D. W. Smith" Greatly eases the task of making transparencies with \s-2TROFF\s+2. .LE 1 .nr c 0\" .ds b A\" .ne 10 .B .LI "A." Additional Facilities: .R .VL 6 .a .e "B\s-2C\s+2\*dAn Arbitrary Precision Desk Calculator Language" "(5/75)" .p "L. L. Cherry and R. Morris" 14 A language and a compiler for doing arbitrary-precision arithmetic. .a .e "D\s-2C\s+2\*dAn Interactive Desk Calculator" "(5/75)" .p "R. Morris and L. L. Cherry" 8 Interactive desk calculator program that does arbitrary-precision integer arithmetic. .a .e "Y\s-2ACC\s+2\*dYet Another Compiler Compiler" "(5/75)" .p "S. C. Johnson" 30 Generates parsers from context-free language specifications. .a .e "L\s-2EX\s+2\*dLexical Analyzer Generator" "(4/77)" .p "M. E. Lesk and E. Schmidt" 13 L\s-2EX\s+2 helps write programs whose control flow is directed by instances of regular expressions in the input stream. .a .e "R\s-2ATFOR\s+2\*dA Preprocessor for a Rational Fortran" "(1/77)" .p "B. W. Kernighan" 12 I\s-2F-ELSE, WHILE\s+2, and other useful control structures. .a .e "The M4 Macro Processor" "(4/77)" .p "B. W. Kernighan and D. M. Ritchie" 6 A general-purpose macro language; can be used as a preprocessor for R\s-2ATFOR\s+2, \*C, etc. .a .e "Make\*dA Program for Maintaining Computer Programs" "(4/77)" .p "S. I. Feldman" 9 .I Make provides a simple mechanism for maintaining up-to-date versions of programs that result from many operations on a number of files. .LE 1 .nr c 0\" .ds b I\" .ne 10 .B .LI "I." Internals, Operations, and Administration: .R .VL 6 .a .e "Setting up P\s-2WB/UNIX\s+2" "(9/77)" .p "R. C. Haight, W. D. Roome, and L. A. Wehr" Procedures used to install \s-2PWB/UNIX\s+2 on the \s-2PDP\s+2-11/45 or /70 and the steps necessary to regenerate all of the \s-2PWB/UNIX\s+2 programs. .a .e "Administrative Advice for P\s-2WB/UNIX\s+2" "(10/77)" .p "R. C. Haight" Hints for approaching operational serenity. .a .e "P\s-2WB/UNIX\s+2 Operations Manual" "(9/77)" .p "M. E. Pearlman" 36 Describes the daily routine at the console. Text (but not pictures) available \%on-line. .a .e "Repairing Damaged P\s-2WB/UNIX\s+2 File Systems" "(10/77)" .p "P. D. Wandzilak" 24 Comes in handy after a power failure, etc. .a .e "P\s-2WB/UNIX\s+2 \s-2RJE\s+2 Administrator's Guide" "(12/77)" .p "A. L. Sabsevitz" What to do when it breaks or when it swamps your file system. .a .e "The U\s-2NIX\s+2 I/O System" "(6/74)" .p "D. M. Ritchie" 9 Describes how to write device drivers for \s-2UNIX\s+2. .a .e "On the Security of U\s-2NIX\s+2" "(6/74)" .p "D. M. Ritchie" 4 A short, but enlightening, discussion. .a .e "U\s-2NIX\s+2 Assembler Reference Manual" "(6/73)" .p "D. M. Ritchie" 12 As a last resort... .a .e "P\s-2WB/UNIX\s+2 Manual Page Macros" "(8/77)" .p "E. M. Piskorik" 7 Tells how to make \s-2PWB/UNIX\s+2 User's Manual pages. .LE 1 .nr c 0\" .ds b R\" .ne 10 .B .LI "R." Recommended Reading\*dnot Included: .R .VL 6 .a .e "Software Tools" .p "B. W. Kernighan and P. J. Plauger" 338 Addison-Wesley, Reading, MA; 1976. .a .if t .ss 16 The U\s-2NIX\s+2 Command Language .br .if t .ss 12 K. Thompson .br In .I "Structured Programming\*dInfotech State of the Art Report." Infotech International Limited, Nicholson House, Maidenhead, Berkshire, England; 1976; pp.~375-84. .LE 1 .LE 1