PWB1/usr/man/man0/documents

'\" 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