document distributed with 4.1BSD

SCCS-vsn: usr.bin/pascal/USD.doc/puman0.n 4.1

diff --git a/usr/src/usr.bin/pascal/USD.doc/puman0.n b/usr/src/usr.bin/pascal/USD.doc/puman0.n
new file mode 100644 (file)
index 0000000..e7564af
--- /dev/null
+++ b/usr/src/usr.bin/pascal/USD.doc/puman0.n
@@ -0,0 +1,134 @@
+.\" Copyright (c) 1980 Regents of the University of California.
+.\" All rights reserved.  The Berkeley software License Agreement
+.\" specifies the terms and conditions for redistribution.
+.\"
+.\"    @(#)puman0.n    4.1 (Berkeley) %G%
+.\"
+.so tmac.p
+.RP
+.TL
+Berkeley Pascal User's Manual
+.br
+Version 2.0 \- October 1980
+.AU
+William N. Joy*
+.AU
+Susan L. Graham*
+.AU
+Charles B. Haley**
+.AI
+Computer Science Division
+.if n Department of Electrical Engineering
+.if n and Computer Science
+.if t Department of Electrical Engineering and Computer Science
+University of California, Berkeley
+Berkeley, California  94720
+...AI
+...MH
+.AB
+.FS
+\s-2(C)\s0 1977, 1979, 1980 William N. Joy, Susan L. Graham, Charles B. Haley
+.FE
+.FS
+* The financial support of the first and second authors' work by
+the National Science Foundation under grants
+MCS74-07644-A04, MCS78-07291, and MCS-8005144,
+and the first author's work by an
+.SM IBM
+Graduate Fellowship
+are gratefully acknowledged.
+.FE
+.FS
+** Author's current address: S & B Associates, 1110 Centennial Ave., Piscataway, NJ  08854
+.FE
+.PP
+Berkeley
+Pascal
+is designed for interactive instructional use
+and runs on the \s-2PDP\s0/11 and \s-2VAX\s0/11 computers.
+Interpretive code is produced,
+providing fast translation at the expense of slower execution speed.
+There is also a fully compatible compiler for the \s-2VAX\s0/11.
+An execution profiler and
+Wirth's cross reference program are also
+available with the system.
+.PP
+The system supports full Pascal.
+The language accepted is 
+`standard' Pascal,
+and a small number of extensions.
+There is an option to suppress the extensions.
+The extensions include a separate compilation facility
+and the ability to link to object modules
+produced from other source languages.
+.PP
+The
+.UM
+gives a list of sources relating to the
+.UX
+system, the Pascal language, and the
+.UP
+system.
+Basic usage examples are provided for the Pascal components
+.PI ,
+.X ,
+.IX ,
+.PC ,
+and
+.XP .
+Errors commonly encountered in these programs are discussed.
+Details are given of special considerations due to the
+interactive implementation.
+A number of examples are provided including many dealing with
+input/output.  An appendix supplements Wirth's
+.I "Pascal Report"
+to form the full definition of the Berkeley implementation of the language.
+.AE
+.ND
+.SH
+'if n 'ND
+Introduction
+.PP
+The
+.UP
+.UM
+consists of five major sections and an appendix.
+In section 1 we give sources of information about 
+.UX ,
+about the programming
+language Pascal, and about the
+Berkeley
+implementation of the language.
+Section 2 introduces the
+Berkeley
+implementation and provides a number of tutorial examples.
+Section 3 discusses the error diagnostics produced by the translators
+.PC
+and
+.PI ,
+and the runtime interpreter
+.X .
+Section 4 describes input/output with special attention given to features
+of the interactive implementation and to features unique to
+.UX .
+Section 5 gives details on the components of the system
+and explanation of all relevant options.
+The
+.UM
+concludes with an appendix to Wirth's
+.I "Pascal Report"
+with which it forms a precise definition of the implementation.
+.SH
+History of the implementation
+.PP
+The first
+Berkeley
+system was written by Ken Thompson in early 1976.
+The main features of the present system were implemented by
+Charles Haley and William Joy during the latter half of 1976.
+Earlier versions of this system have been in use since January, 1977.
+.PP
+The system was moved to the \s-2VAX\s0-11
+by Peter Kessler and Kirk McKusick
+with the porting of the interpreter in the spring of 1979,
+and the implementation of the compiler in the summer of 1980.