Research V6 development
authorKen Thompson <ken@research.uucp>
Fri, 27 Jun 1975 00:07:28 +0000 (19:07 -0500)
committerKen Thompson <ken@research.uucp>
Fri, 27 Jun 1975 00:07:28 +0000 (19:07 -0500)
Work on file usr/doc/hel/hel1
Work on file usr/doc/hel/hel2
Work on file usr/doc/hel/junk
Work on file usr/doc/hel/hel3
Work on file usr/doc/hel/hel5
Work on file usr/doc/hel/hel0
Work on file usr/doc/hel/hel4

Co-Authored-By: Dennis Ritchie <dmr@research.uucp>
Synthesized-from: v6

usr/doc/hel/hel0 [new file with mode: 0644]
usr/doc/hel/hel1 [new file with mode: 0644]
usr/doc/hel/hel2 [new file with mode: 0644]
usr/doc/hel/hel3 [new file with mode: 0644]
usr/doc/hel/hel4 [new file with mode: 0644]
usr/doc/hel/hel5 [new file with mode: 0644]
usr/doc/hel/junk [new file with mode: 0644]

diff --git a/usr/doc/hel/hel0 b/usr/doc/hel/hel0
new file mode 100644 (file)
index 0000000..1982dbc
--- /dev/null
@@ -0,0 +1,93 @@
+.hy 9
+.de sh
+.sp
+.ne2
+.mk
+.in 7
+.ti -7
+.if n \\$1
+.if t \(sq \\$1
+.br
+.br
+.rt
+..
+.de ss
+.if n $\\ns
+.if t .s0
+.nr s 0
+..
+.de s0
+.if !\\ns+100 $\l'.3i'
+.if \\ns+100 .if !\\ns-10 N. C.
+.if \\ns-10 .s1
+..
+.de s1
+.nr s \\ns+9/10
+.if !\\ns-10 .s2
+.if \\ns-10 .s3
+..
+.de s2
+$\\ns
+..
+.de s3
+.nr s \\ns+4/5*5
+$\\ns
+..
+.de sz
+.nr s +0\\$2
+.if !0\\$2 .nr s 0-10000
+..
+.de op
+.br
+.if t .in 7+\w'\(bu 'u
+.if n .in 7+2
+.if n .ti -2
+.if t .ti -\w'\(bu 'u
+.if t .ta \w'\(bu 'u
+.if n .ta 2
+.if n -
+.if t \(bu     \\
+..
+.de hd
+.ev 1
+.sp2
+.tl ''U\s8NIX\s10 Summary''
+.sp
+.ev
+..
+.sp 2
+.ce
+\s12U\s10NIX\s12 Summary (DRAFT)\s10
+.sp2
+.de h0
+.de h1
+.ti 0
+\\$1
+\\..
+.h2
+..
+.wh 0 hd
+.wh -7 fo
+.de h2
+.sp
+.ft B
+.ne 4
+.h1
+.ft R
+..
+.if n .na
+.br
+.de fo
+.ev 2
+.sp 2
+.tl ''%''
+'bp
+.ev
+..
+.if n .ds lq ""
+.if t .ds lq ``
+.if n .ds rq ""
+.if t .ds rq ''
+.nr a 0 1
+.nr b 0 1
+.nr c 0 1
diff --git a/usr/doc/hel/hel1 b/usr/doc/hel/hel1
new file mode 100644 (file)
index 0000000..7b1faa5
--- /dev/null
@@ -0,0 +1,161 @@
+.h0 "A. Hardware"
+.in0
+.sp
+U\s8NIX\s10 runs on 
+a DEC PDP11/40*, 11/45 or 11/70
+with at least the following equipment:
+.in+5
+.nf
+48K to 124K words of managed memory: parity not used,
+disk: RP03, RP04, RK05(preferably 2) or equivalent,
+console typewriter,
+clock: KW11-L or KW11-P,
+extended instruction set KE11-E, on 11/40 only.
+.in -5
+.fi
+The system is normally distributed on 9-track tape or RK05 packs.
+.br
+The following equipment is strongly recommended:
+.in +5
+.nf
+communications controllers such as DL11, DC11 or DH11,
+full duplex 96-character ASCII terminals,
+9-track tape, or extra disk for system backup.
+.in-5
+.fi
+The minimum memory and disk space specified is enough to run
+and maintain U\s8NIX\s10.
+More will be needed to keep all source on line, or to handle
+a large number of users,
+big data bases, diversified complements of devices, or large
+programs.
+U\s8NIX\s10 
+does swapping and reentrant sharing
+of user code to minimize main memory requirements.
+The resident code of U\s8NIX\s10 occupies 20-22K depending
+on configuration.
+.sp
+An 11/40 is not advisable for heavy floating point
+work, as U\s8NIX\s10 on this hardware uses interpreted 11/45 floating point.
+.h0 "B. Software"
+.sp
+All the programs available as U\s8NIX\s10
+commands are listed.
+Every command, including all options, is issued as just one
+line, unless specifically noted as \*(lqinteractive\*(rq.
+Interactive programs can be made to run from a prepared script
+simply by redirecting input.
+.sp
+File processing commands
+that go from standard input to standard output
+are noted as usable as filters.
+The piping facility of the Shell may be used
+to connect filters directly to the input or output
+of other programs.
+.sp
+Commercially distributed U\s8NIX\s10
+normally excludes software listed
+in Section 5, ``Typesetting.''
+Source code is included except as noted.
+.h0 "\n+a Basic Software"
+.nr b 0
+.sp
+This package
+includes time-sharing operating
+system with utilities, machine language assembler and the 
+compiler for the programming language C\(emenough
+software to
+write and run new applications
+and to maintain or modify U\s8NIX\s10 itself.
+.h0 "\na.\n+b Operating System"
+.sh UNIX
+The basic resident code
+on which everything else depends.
+Supports the system calls, and maintains the file system.
+A general description of U\s8NIX\s10 design
+philosophy and system facilities appeared in
+the Communications of the ACM, July, 1974.
+Further capabilities include:
+.op
+Automatically supported reentrant code.
+.op
+Separate instruction and data spaces on 11/45 and 11/70.
+.op
+``Group'' access permissions allow cooperative projects,
+with overlapping memberships.
+.op
+Timer-interrupt sampling and interprocess monitoring
+for debugging and measurement.
+.sh Manual
+Printed manuals for U\s8NIX\s10 and all its software,
+except where other manuals exist.
+.op
+U\s8NIX\s10 Programmer's Manual.
+.op
+The U\s8NIX\s10 Time-Sharing System, reprint setting forth
+design principles.
+.op
+U\s8NIX\s10 for Beginners.
+.op
+The U\s8NIX\s10 I-O System.
+.op
+On the Security of U\s8NIX\s10.
+.sh (DEV)
+All I/O is logically synchronous.
+Normally, invisible buffering makes all physical
+record structure transparent and exploits the
+hardware's ability to do overlapped I/O.
+Unbuffered physical record
+I/O is available for unusual applications.
+Drivers for these devices are
+available; others can be easily written:
+.op
+Asynchronous interfaces: DC11, DH11, DL11.
+Support for most common ASCII terminals.
+.op
+Synchronous interface: DP11.
+.op
+Automatic calling unit interface: DN11.
+.op
+Line printer: LP11.
+.op
+Magnetic tape: TU10 and TU16.
+.op
+DECtape*: TC11.
+.op
+Paper tape: PC11.
+.op
+Fixed head disk: RS11, RS03 and RS04.
+.op
+Pack type disk: RP03 and RP04, one or more logical
+devices per physical device,
+minimum-latency seek scheduling.
+.op
+Cartridge-type disk: RK05, one or more physical devices per
+logical device.
+.op
+Null device.
+.op
+Physical memory of PDP11, or mapped memory in resident system.
+.op
+Phototypesetter: Graphic Systems System/1 through DR11C.
+.op
+Voice synthesizer: V\s8OTRAX\s10* through DC11.
+Includes T\s8OUCH\s10-T\s8ONE\s10\(rg input.
+.sh BOOT
+Procedures to get U\s8NIX\s10 up
+on a naked machine.
+.sh Manual
+Setting up U\s8NIX\s10.
+.sh MKCONF
+Tailor device-dependent system code to hardware configuration.
+Other changes, such as optimal
+assignment of directories to devices, inclusion of floating
+point simulator, or installation of device names in file system
+can then be made at leisure.
+(As distributed, U\s8NIX\s10 can 
+be brought up directly on any acceptable CPU
+with any acceptable disk, any sufficient amount of core
+and either clock.)
+.sh Manual
+Printed manual on setting up U\s8NIX\s10.
diff --git a/usr/doc/hel/hel2 b/usr/doc/hel/hel2
new file mode 100644 (file)
index 0000000..d8994df
--- /dev/null
@@ -0,0 +1,395 @@
+.h0 "\na.\n+b User Access Control"
+.sh LOGIN
+Sign on as a new user.
+.op
+Verify password and establish user's 
+individual and group (project) identity.
+.op
+Adapt to characteristics of terminal.
+.op
+Establish working directory.
+.op
+Announce presence of mail (from MAIL).
+.op
+Publish message of the day.
+.op
+Start command interpreter or other initial program.
+.sh PASSWD
+Change a password.
+.op
+User can change his own password.
+.op
+Passwords are kept encrypted for better security.
+.sh NEWGRP
+Change working group (project).
+Protects against changes to unauthorized projects.
+.h0 "\na.\n+b File Manipulation"
+.sh CAT
+Concatenate one or more files onto standard output.
+Particularly used for unadorned printing, for
+inserting data into a pipeline,
+and for buffering output that comes in dribs and drabs.
+.op
+Usable as filter.
+.sh CP
+Copy one file to another.
+Works on any file without distinction as to contents.
+.sh PR
+Print files with title, date, and page number on every page.
+.op
+Multicolumn output.
+.op
+Parallel column merge of several files.
+.op
+Usable as a filter.
+.sh OPR
+Off line print.
+Spools arbitrary files to the line printer.
+.op
+Usable as a filter.
+.sh SPLIT
+Split a large file into more manageable pieces.
+Is occasionally necessary for editing (ED).
+..
+.sh ED
+Interactive context editor.
+Can work on single lines, blocks of lines, or all pattern-selected
+lines in a given range.
+.op
+Finds lines by number or pattern.
+.op
+Random access to lines.
+.op
+Add, delete, change, copy or move lines.
+.op
+Permute or split contents of a line.
+.op
+Replace one or all instances of a pattern within a line.
+.op
+Combine or split files.
+.op
+Escape to Shell (U\s8NIX\s10 command language) during editing.
+.ne3
+.op
+Patterns may include:
+.in +2
+specified characters,
+.br
+don't care characters,
+.br
+choices among characters,
+.br
+repetitions of above,
+.br
+beginning of line,
+.br
+end of line.
+.in -2
+.op
+All operations may be done globally on
+every pattern-selected line in a given range.
+.sh Manual
+Introductory manual for ED.
+.sh DD
+Physical file format translator,
+for exchanging data with foreign
+systems, especially OS/360.
+.sh STTY
+Sets up options for optimal control of a terminal.
+In so far as they are deducible from the input, these
+options are set automatically by LOGIN.
+.op
+Half vs. full duplex.
+.op
+Carriage return+line feed vs. newline.
+.op
+Interpretation of tabs.
+.op
+Parity.
+.op
+Mapping of upper case to lower.
+.op
+Raw vs. edited input.
+.op
+Delays for tabs, newlines and carriage returns.
+.h0 "\na.\n+b Manipulation of Directories and File Names"
+.sh RM
+Remove a file.
+Only the name goes away if any other names are linked to the file.
+.sh LN
+\*(lqLink\*(rq another name (alias) to an existing file.
+.sh MV
+Move a file.
+.op
+Used for renaming files or directories.
+.sh CHMOD
+Change permissions on one or more files.
+Executable by files' owner.
+.sh CHOWN
+Change owner of one or more files.
+.sh CHGRP
+Change group (project) to which a file belongs.
+.sh MKDIR
+Make a new directory.
+.sh RMDIR
+Remove a directory.
+.sh CHDIR
+Change working directory.
+.sh FIND
+Prowl the directory
+hierarchy finding
+every file that meets
+specified criteria.
+.op
+These criteria are understood:
+.in +2
+.nf
+spelling of name matches a given pattern,
+creation date in given range,
+date of last use in given range,
+permissions,
+owner,
+characteristics of device files,
+boolean combinations of above.
+.in -2
+.fi
+.op
+Any directory may be considered to be the root.
+.op
+Specified commands may be performed on every file found.
+.sh DSW
+Interactively step through a directory,
+deleting or keeping files.
+.h0 "\na.\n+b Running of Programs"
+.sh SH
+The Shell, or command language interpreter.
+Provides \*(lqbackground\*(rq and macro capability when
+run with a file of commands as input.
+.br
+.op
+Any executable object file is automatically a command.
+.op
+Redirect standard input or standard output.
+.op
+Operators to compose compound commands:
+.in+2
+`;' for sequential execution,
+.br
+`|' for functional composition with output of one
+command taken directly as input to another running simultaneously,
+.br
+`&' for asynchronous operation,
+.br
+parentheses for grouping.
+.in -2
+.op
+Substitutable arguments.
+.op
+Construction of argument lists from all file names
+satisfying specified patterns.
+.op
+Collects command usage statistics.
+.sh IF
+A conditional statement for Shell programs.
+.op
+String comparison.
+.op
+Querying file accessibility.
+.sh GOTO
+A \*(lqgo-to\*(rq statement for Shell programs.
+.sh WAIT
+Wait for termination of asynchronously running processes.
+.sh EXIT
+Terminate a Shell program.
+Useful with IF.
+.sh ECHO
+Print remainder of command line.
+Useful for diagnostic or prompting data in Shell programs,
+or for inserting data into a pipeline.
+.sh SLEEP
+Suspend execution for a specified time.
+.sh NOHUP
+Run a command immune to hanging up the terminal.
+.sh NICE
+Run a command in low (or high) priority.
+.sh KILL
+Terminate named processes.
+.sh CRON
+A table of actions to be taken at specified times.
+.op
+Actions are arbitrary Shell (SH) scripts.
+.op
+Times are
+conjunctions of month, day of month, day of week, hour
+and minute.
+Ranges are specifiable for each.
+.sh TEE
+Pass data between processes and divert a copy into a file.
+Used as a filter.
+.h0 "\na.\n+b Status Inquiries"
+.sh LS
+List the names of one, several, or all files in one or more directories.
+.op
+Alphabetic or temporal sorting, up or down.
+.op
+Optional information:
+size,
+owner,
+group,
+date last modified,
+date last accessed,
+permissions,
+i-node number.
+.sh FILE
+Tries to determine 
+what kind of information is in a file by consulting
+the file system index and by reading the file itself.
+.sh DATE
+System date routine.
+Has considerable knowledge
+of calendric and horological peculiarities.
+.op
+Print present date, day of week, local time.
+.op
+May set U\s8NIX\s10's idea of date and time.
+.sh DF
+Report amount of free space on file system devices.
+.sh DU
+Print a summary of total space occupied by all files in a hierarchy.
+.sh WHO
+Tell who's on the system.
+.op
+List of presently logged in users,
+ports and times on.
+.op
+Optional history of all logins and logouts.
+.sh PS
+Report on all active processes attached to a terminal.
+.op
+Gives all commands being executed.
+.op
+Can also report on other terminals.
+.op
+Extended status information available:
+.in+2
+.nf
+state and scheduling info,
+priority,
+attached terminal,
+what it's waiting for,
+size.
+.fi
+.in -2
+.fi
+.sh TTY
+Find name of your terminal.
+.sh PWD
+Print name of your working directory.
+.sh PFE
+Print type of last floating exception.
+.h0 "\na.\n+b Backup and Maintenance"
+.sh MOUNT
+Attach a device containing
+a file system to
+the tree of directories.
+Protects against nonsense arrangements.
+.sh UMOUNT
+Remove the file system contained on a device
+from the tree of directories.
+Protects against removing a busy device.
+.sh MKFS
+Make a new file system on a device.
+.sh MKNOD
+Make an i-node (file system entry) for a special file.
+Special files are
+physical devices,
+virtual devices, physical memory, etc.
+.sh TP
+Manage file archives on magnetic tape or DEC tape.
+.op
+Collect files into an archive.
+.op
+Update DECtape archive by date.
+.op
+Replace or delete DECtape files.
+.op
+Table of contents.
+.op
+Retrieve from archive.
+.sh DUMP
+Dump the file system
+stored on a specified device, selectively by date, or indiscriminately.
+.sh RESTOR
+Restore a dumped file system,
+or selectively retrieve parts thereof.
+.sh SU
+Temporarily become the super user with all the rights and privileges
+thereof.
+Requires a password.
+.sh DCHECK
+.sh ICHECK
+.sh NCHECK
+.sp -2
+Check consistency of file system.
+.op
+Gross statistics:
+.in +2
+.nf
+number of files,
+number of directories,
+number of special files,
+spaced used,
+space free.
+.in -2
+.fi
+.op
+Report of duplicate use of space.
+.op
+Retrieval of lost space.
+.op
+Report of inaccessible files.
+.op
+Check consistency of directories.
+.op
+List names of all files.
+.sh CLRI
+Peremptorily expunge a file and its space from a file system.
+Used in putting damaged file systems together again.
+.sh SYNC
+Force all outstanding I/O on the system to completion.
+Used to shut down gracefully.
+.h0 "\na.\n+b Accounting"
+.in0
+.sp
+These routines use floating point.
+The timing information on which the reports are based can be
+manually cleared or shut off completely.
+.sh AC
+Publish cumulative connect time report.
+.op
+Connect time by user or by day.
+.op
+For all users or for selected users.
+.sh SA
+Publish Shell accounting
+report.
+Gives usage information on each command executed.
+.op
+Number of times used.
+.op
+Total system time, user time and elapsed time.
+.op
+Optional averages and percentages.
+.op
+Sorting on various fields.
+.h0 "\na.\n+b Inter-user Communication"
+.sh MAIL
+Mail a message to one or more users.
+Also used to read and dispose of incoming mail.
+The presence of mail is announced by LOGIN.
+.sh WRITE
+Establish direct terminal communication with another user.
+.sh WALL
+Write to all users.
+.sh MESG
+Inhibit receipt of messages from WRITE and WALL.
diff --git a/usr/doc/hel/hel3 b/usr/doc/hel/hel3
new file mode 100644 (file)
index 0000000..e7a9577
--- /dev/null
@@ -0,0 +1,557 @@
+.h0 "\na.\n+b Basic Program Development Package"
+.nr c 0 1
+.sp
+.in0
+A kit of fundamental programming tools.
+Some of these utilities are used as integral parts of
+the higher level languages described below.
+.sh AR
+Archive and library maintainer.
+Combines several files into one for housekeeping efficiency.
+Archive files are used by the link editor LD as libraries.
+.op
+Create new archive.
+.op
+Update archive by date.
+.op
+Replace or delete files.
+.op
+Table of contents.
+.op
+Retrieve from archive.
+.sh AS
+Assembler.
+Similar to PAL-11, but different in detail.
+.op
+Creates object program consisting of
+.in+2
+.nf
+code, possibly read-only,
+initialized data or read-write code,
+uninitialized data.
+.in -2
+.fi
+.op
+Relocatable object code is directly executable without
+further transformation.
+.op
+Object code normally includes a symbol table.
+.op
+Combines source files.
+.op
+Local labels.
+.op
+Conditional assembly.
+.op
+\*(lqConditional jump\*(rq instructions become
+branches or branches plus jumps depending on distance.
+.sh Manual
+Printed manual for the assembly language.
+.sh Library
+The basic run-time library.
+These routines are used freely by all system software.
+.op
+Formatted writing on standard output.
+.op
+Time conversions.
+.op
+Convert integer and floating numbers to ASCII and vice versa.
+.op
+Elementary functions: sin, cos, log, exp, atan, sqrt, gamma.
+.op
+Password encryption.
+.op
+Quicksort.
+.op
+Buffered character-by-character I/O.
+.op
+Random number generator.
+.op
+Floating point interpreter for 11/40's and non-floating point
+machines.
+.sh (LIBP)
+An elaborated I/O library.
+.op
+Formatted input and output.
+.op
+Ability to put characters back into input streams.
+.sh Manual
+Printed manual for LIBP.
+.sh DB
+Interactive post-mortem debugger.
+Works on core dump files, such as are produced by all
+program aborts, on object files, or on any arbitrary file.
+.op
+Symbolic addressing of files that have symbol tables.
+.op
+Octal, decimal or ASCII output.
+.op
+Symbolic disassembly.
+.op
+Octal or decimal patching.
+.sh OD
+Dump any file.
+.op
+Output options include:
+.in+2
+octal or decimal by words,
+.br
+octal by bytes,
+.br
+ASCII,
+.br
+opcodes,
+.br
+hexadecimal,
+.br
+any combination of the above.
+.op
+Range of dumping is controllable.
+.sh LD
+Link edit.
+Combine relocatable object files.
+Insert required routines from specified libraries.
+.op
+Resulting code may be sharable.
+.op
+Resulting code may have separate instruction and data spaces.
+.sh NM
+Print the namelist (symbol table) of an object program.
+Provides control over the style and order of
+names that are printed.
+.sh SIZE
+Report the core requirements
+of one or more object files.
+.sh STRIP
+Remove the relocation and symbol table information from
+an object file to save space.
+.sh TIME
+Run a command and report timing information on it.
+.sh PROF
+Construct a profile of time spent per routine
+from statistics gathered by time-sampling the
+execution of a program.
+Uses floating point.
+.op
+Subroutine call frequency and average times for C programs.
+.h0 "\na.\n+b The Programming Language ``C''"
+.nr c 0 1
+.nr b 0 1
+.sh CC
+Compile and/or link edits programs in the C
+language.
+The U\s8NIX\s10 operating system, most of the
+subsystems and C itself are written in C.
+.op
+Full general purpose language
+designed for structured programming.
+.op
+Data types:
+.nf
+.in+2
+character,
+integer,
+float,
+double,
+pointers to all types,
+arrays of all types,
+structures of all types,
+functions returning all types.
+.in-2
+.fi
+.op
+Operations intended to give
+access to full machine facility, including to-memory
+operations and data-sensitive
+pointer arithmetic.
+.op
+Macro preprocessor for parameterized code and inclusion of
+standard files.
+.op
+All procedures recursive, with parameters by value.
+.op
+Natural coercions.
+.op
+True compiled object code capitalizing on
+addressing capability of the PDP11.
+.op
+Runtime library gives access to all system facilities.
+.sh Manuals
+Printed manual and tutorial for the C language.
+.sh CDB
+An interactive debugger tailored for use with C.
+.op
+Usable in real time or post-mortem.
+.op
+The debugger is a completely separate process from the debuggee.
+No debugging code is loaded with debuggee.
+.op
+Prints all kinds of data in natural notation:
+.nf
+.in+2
+character,
+integer (octal and decimal),
+float,
+double,
+machine instructions (disassembled).
+.in -2
+.fi
+.op
+Stack trace and fault identification.
+.op
+Breakpoint tracing.
+.h0 "\n+a Other Languages"
+.nr b 0 1
+.h0 "\na.\n+b FORTRAN"
+.sh FC
+Compile and/or link-edit FORTRAN IV programs.
+Object code is \*(lqthreaded\*(rq.
+Relies heavily on floating point.
+.op
+Idiosyncracies:
+.nf
+.in+2
+free form, lower-case source code,
+no arithmetic statement functions,
+unformatted I/O requires record lengths agree,
+no BACKSPACE,
+no P FORMAT control on input.
+.in-2
+.fi
+.op
+Handles mixed-mode arithmetic,
+general subscripts and general DO limits.
+.op
+32-bit integer arithmetic.
+.op
+Free format numeric input.
+.op
+Understands these nonstandard specifications:
+.in+2
+LOGICAL*1, *2, *4,
+.br
+INTEGER*2, *4,
+.br
+REAL*4, *8,
+.br
+COMPLEX*8, *16,
+.br
+IMPLICIT.
+.in-2
+.fi
+.sh RC
+``Ratfor'', a preprocessor that adds rational
+control structure \o'a\(ga' la C to FORTRAN.
+.op
+Else, for, while,
+repeat...until
+statements.
+.op
+Symbolic constants.
+.op
+File insertion.
+.op
+Compound statements.
+.op
+Can produce genuine FORTRAN to carry away.
+.sh Manual
+Printed manual for Ratfor.
+.h0 "\na.\n+b Other Algorithmic Languages"
+.nr c 0 1
+.sh BAS
+An interpreter, similar in style to BASIC, that allows
+immediate execution of unnumbered statements, or deferred
+execution of numbered statements.
+.op
+Statements include:
+.in+2
+.nf
+comment,
+dump,
+for...next,
+goto,
+if...else...fi,
+list,
+print,
+prompt,
+return,
+run,
+save.
+.fi
+.op
+All calculations double precision.
+.op
+Recursive function defining and calling.
+.op
+Builtin functions include log, exp, sin, cos, atn, int,
+sqr, abs, rnd.
+.op
+Escape to ED for complex program editing.
+.op
+Usable as a filter.
+.sh DC
+Programmable reverse Polish desk calculator.
+Has named storage locations as well
+as conventional stack for holding integers or programs.
+.op
+Unlimited precision decimal arithmetic.
+.op
+Appropriate treatment of decimal fractions.
+.op
+Arbitrary input and output radices, in particular
+binary, octal, decimal and hexadecimal.
+.op
+Operators include:
+.in+2
+.nf
++ \- * /
+remainder, power, square root,
+load, store, duplicate, clear,
+print, enter program text, execute.
+.in-2
+.fi
+.op
+Usable as a filter.
+.sh BC
+A C-like interface to the desk calculator DC.
+.op
+All the capabilities of DC with a high-level syntax.
+.op
+Arrays and recursive functions.
+.op
+Immediate evaluation of expressions and evaluation of
+functions upon call.
+.op
+Arbitrary precision elementary functions:
+exp, sin, cos, atan, J\v'.3'\s8n\s10\v'-.3'.
+.op
+Go-to-less programming.
+.op
+Usable as a filter.
+.sh Manual
+Printed manual for BC.
+.sh SNO
+An interpreter very similar to SNOBOL 3.
+.op
+Limitations:
+.nf
+.in+2
+function definitions are static,
+pattern matches are always anchored,
+no built-in functions.
+.in-2
+.fi
+.op
+Usable as a filter.
+.sh Manual
+Reprint of basic article.
+.h0 "\na.\n+b Macroprocessing"
+.nr c 0 1
+.sh M6
+A general purpose macroprocessor.
+.op
+Stream-oriented, recognizes macros anywhere in text.
+.op
+Integer arithmetic.
+.op
+Usable as a filter.
+.sh Manual
+Printed manual for M6.
+.h0 "\na.\n+b Compiler-compilers"
+.nr c 0 1
+.sh TMG
+A classical top-down compiler-compiler language.
+Provides a formalism for syntax-directed translation.
+Produces driving tables to be loaded with a standard
+interpreter.
+.op
+Resulting compilers can have arbitrary tables kept in
+paged secondary store.
+.op
+Integer arithmetic capability.
+.op
+Syntactic function capability (similar to ALGOL 68
+metaproductions).
+.sh Manual
+Printed manual for the TMG compiler-writing system.
+.sh YACC
+An LR(1)-based compiler writing system.
+During execution of resulting
+parsers, arbitrary C-language, Ratfor or FORTRAN functions may be
+called to do code generation or semantic actions.
+.op
+BNF syntax specifications.
+.op
+Handles precedence relations.
+.op
+Accepts formally ambiguous grammars
+with non-BNF resolution rules.
+.op
+Optimizes space 
+taken by driving tables.
+.sh Manual
+Printed manual for the YACC compiler-writing system.
+.h0 "\n+a Word Processing"
+.nr b 0 1
+.sh ROFF
+A typesetting program for terminals.
+Easy for nontechnical people to learn, and good
+for most ordinary kinds of documents.
+Input consists of data lines intermixed with control lines,
+such as
+.ta  8n
+.ti 10
+.li
+.sp 2  insert two lines of space
+.ti10
+.li
+.ce    center the next line
+.br
+.op
+Justification of either or both margins.
+.op
+Automatic hyphenation.
+.op
+Generalized running heads and feet, with even-odd page
+capability, numbering, etc.
+.op
+Definable macros for frequently used
+control sequences (no substitutable arguments).
+.op
+All 4 margins and page size dynamically adjustable.
+.op
+Hanging indents and one-line indents.
+.op
+Absolute and relative parameter settings.
+.op
+Optional legal-style numbering of output lines.
+.op
+Multiple file capability.
+.sh CREF
+Make cross-reference listings of a collection of files.
+Each symbol is listed together with file, line number, and
+text of each line in which it occurs.
+.op
+Assembler or C language.
+.op
+Gathering or suppressing references to selected symbols.
+.op
+Last symbol defined may replace line number.
+.op
+Various ways to
+sort output available.
+.op
+Selective print of uniquely occurring symbols.
+.sh INDEX
+Make cross-reference indexes of English text.
+.op
+Handles lists of specific index terms or excluded terms.
+.op
+Handles words hyphenated across lines.
+.op
+Understands TROFF and NROFF output, so can gather
+references according to final pagination.
+.op
+Output capabilities like CREF.
+.op
+Frequency counts.
+.sh FORM
+Form letter generator.
+Remembers any number of forms and stock phrases such as names
+and addresses.
+Output usually intended to be ROFFed.
+.op
+Anything that is typed in can be remembered for later use.
+.op
+Runs interactively, querying only for those items
+that are not in its memory.
+.op
+Any item may call for the inclusion
+of other items.
+For example, full name, address, first name, title, etc.,
+may be separately retrieved from one name key.
+.sh FED
+Editor for 
+the memory used by FORM.
+Extract any item, turn it over to context editor ED for
+editing, and put it back when done.
+.op
+List names of selected items.
+.op
+Print contents of selected item.
+.sh SORT
+Sort or merge ASCII files line-by-line.
+.op
+Sort up or down.
+.op
+Sort lexicographically or on numeric key.
+.op
+Multiple keys located by delimiters or by character position.
+.op
+May sort upper case together with lower into dictionary order.
+.op
+Usable as a filter.
+.sh UNIQ
+Collapse successive duplicate lines
+in a file into one line.
+.op
+Publishes lines that were originally unique,
+duplicated, or both.
+.op
+May give redundancy count for each line.
+.op
+Usable as a filter.
+.sh TR
+Do one-to-one character translation according to
+an arbitrary code.
+.op
+May coalesce selected repeated characters.
+.op
+May delete selected characters.
+.op
+Usable as a filter.
+.sh DIFF
+Report line changes, additions and deletions necessary to bring two files
+into agreement.
+.op
+May produce an editor script to convert one file into another.
+.sh COMM
+Identify common lines in two sorted files.
+Output in up to 3 columns shows lines present in first file only,
+present in both, and/or present in second only.
+.sh CMP
+Compare two files and report disagreeing bytes.
+.sh GREP
+Print all lines in a file that satisfy
+a pattern of the kind used in the editor ED.
+.op
+May print all lines that fail to match.
+.op
+May print count of hits.
+.op
+Usable as a filter.
+.sh WC
+Count the lines and \*(lqwords\*(rq (blank-separated strings) in a file.
+.op
+Usable as a filter.
+.sh TYPO
+Find typographical errors.
+Statistically analyzes all the words in a text, weeds out
+several thousand familiar ones, and publishes the rest sorted so that
+the most improbably spelled ones
+tend to come to the top of the list.
+.sh GSI
+Simulate Model 37 Teletype facilities on
+GSI-300, DASI and other Diablo-mechanism terminals.
+.op
+Gives half-line and reverse platen motions.
+.op
+Approximates Greek letters and other special characters
+by overstriking.
+.op
+Usable as a filter.
+.sh COL
+Canonicalize files with reverse line feeds
+for one-pass printing.
+.op
+Usable as a filter.
diff --git a/usr/doc/hel/hel4 b/usr/doc/hel/hel4
new file mode 100644 (file)
index 0000000..8e54614
--- /dev/null
@@ -0,0 +1,40 @@
+.h0 "\n+a Novelties"
+.in0
+.sp
+Source code for game-playing programs is not distributed.
+.nr b 0 1
+.sh SPEAK
+Driver for Vocal Interface's V\s8OTRAX\s10 speech synthesizer.
+Reads input text and utters it.
+.op
+Associative memory allows pronunciation rules
+for whole words or word fragments to
+be added, changed, deleted or queried.
+.op
+Can use different memories for different languages.
+.op
+Usable as a filter to make the output of
+any other program audible.
+.sh CHESS
+This chess-playing program scored
+1-2-1 and 3-0-1 in the 1973 and 1974 Computer Chess
+Championships.
+.sh BJ
+A blackjack dealer.
+.sh CUBIC
+An accomplished player of 4\(mu4\(mu4 tic-tac-toe.
+.sh MOO
+A fascinating number-guessing game.
+.sh CAL
+Prints a calendar of specified month and year.
+.sh UNITS
+Converts amounts between different scales of measurement.
+Knows hundreds of units.
+For example, how many km/sec is a parsec/megayear?
+.sh TTT
+A tic-tac-toe program that learns.
+It never makes the same mistake twice.
+.sh QUIZ
+Tests your knowledge of Shakespeare, Presidents, capitals, etc.
+.sh WUMP
+Hunt the wumpus, thrilling search in a dangerous cave.
diff --git a/usr/doc/hel/hel5 b/usr/doc/hel/hel5
new file mode 100644 (file)
index 0000000..c618328
--- /dev/null
@@ -0,0 +1,282 @@
+.h0 "\\n+a Typesetting"
+.nr b 0 1
+.sp
+.in0
+This software is distributed separately as an enhancement
+to U\s8NIX\s10.
+.h0 "\na.\n+b Formatters"
+.sp
+.in0
+High programming skill is required to
+exploit the formatting capabilities
+of these programs, although unskilled personnel can
+easily be trained to enter documents according to canned
+formats.
+Terminal-oriented and
+typesetter-oriented formatters are sufficiently compatible
+that it is usually possible to define
+interchangeable formats.
+.sh NROFF
+Advanced typesetting for terminals.
+Style similar to ROFF, but capable of much more elaborate
+feats of formatting, at a price in ease of use.
+.op
+All ROFF capabilities available or definable.
+.op
+Completely definable page format keyed to dynamically planted
+\*(lqinterrupts\*(rq at specified lines.
+.op
+Maintains several separately definable typesetting environments (e.g. one for
+body text, one for footnotes, and one for unusually elaborate
+headings).
+.op
+Arbitrary number of output pools can be combined at will.
+.op
+Macros with substitutable arguments, and macros invocable
+in mid-line.
+.op
+Computation and printing of numerical quantities.
+.op
+Conditional execution of macros.
+.op
+Tabular layout facility.
+.op
+Multicolumn output on terminals capable of reverse line feed,
+or through the postprocessor COL.
+.op
+Usable as a filter
+.sh Manual
+Printed manual for NROFF.
+.sh TROFF
+Advanced phototypesetting for the Graphic Systems System/1.
+Provides facilities like NROFF, augmented as follows.
+This Summary was typeset by TROFF.
+.op
+Vocabulary of several 102-character fonts (4 simultaneously)
+in 15 sizes.
+.op
+Positions expressible in inches, centimeters, ems, points,
+machine units
+or arithmetic combinations thereof.
+.op
+Access to character-width computation for unusually difficult
+layout problems.
+.op
+Overstrikes, built-up brackets, horizontal and vertical line drawing.
+.op
+Dynamic relative or absolute positioning and size selection,
+globally or at the character level.
+.op
+Terminal output for rough sampling of the product,
+usually needs a wide platen.
+Not a substitute for NROFF.
+.op
+Usable as a filter.
+.sh Manuals
+Printed manual and tutorial for TROFF.
+.sh EQN
+A mathematical typesetting preprocessor for TROFF.
+Translates easily readable formulas, either in-line or displayed, into 
+detailed typesetting instructions.
+Formulas are written in a style like this:
+.ti10m
+.EQ
+sigma sup 2 ~=~ 1 over N sum from i=1 to N ( x sub i - x bar ) sup 2
+.EN
+.br
+which produces this:
+.sp .1
+.ti 10m
+.EQ
+.nr 99 \n(.s
+.nr 98 \n(.f
+.ps 10
+.ft I
+.ds 11 "\(*s
+.nr 11 \w'\*(11'
+.ps 8
+.ds 12 "\fR2\fP
+.nr 12 \w'\*(12'
+.as 11 \v'-24u'\s8\|\*(12\s10\v'24u'
+.ps 10
+.nr 11 \n(11+\n(12+\w'\s8\|'
+.ds 12 "\|\|
+.nr 12 \w'\*(12'
+.as 11 "\*(12
+.nr 11 \w'\*(11'
+.ds 12 "\|=\|
+.nr 12 \w'\*(12'
+.as 11 "\*(12
+.nr 11 \w'\*(11'
+.ds 12 "\|\|
+.nr 12 \w'\*(12'
+.as 11 "\*(12
+.nr 11 \w'\*(11'
+.ds 12 "\fR1\fP
+.nr 12 \w'\*(12'
+.ds 13 "N
+.nr 13 \w'\*(13'
+.nr 14 \n(12
+.if \n(13-\n(14 .nr 14 \n(13
+.nr 14 \n(14+.4m
+.ds 12 \v'42u'\h'\n(14u-\n(13u/2u'\*(13\
+\h'-\n(13u-\n(12u/2u'\v'-78u'\*(12\
+\h'-\n(14u-\n(12u/2u'\v'18u'\l'\n(14u'\v'18u'
+.nr 12 \n(14
+.as 11 "\*(12
+.nr 11 \w'\*(11'
+.ds 12 \v'.3m'\s16\(*S\s10\v'-.3m'
+.nr 12 \w'\*(12'
+'ps 7
+.ds 13 "i\|=\|\fR1\fP
+.nr 13 \w'\*(13'
+'ps 7
+.ds 14 "N
+.nr 14 \w'\*(14'
+'ps 10
+.nr 15 \n(12
+.if \n(13-\n(15 .nr 15 \n(13
+.if \n(14-\n(15 .nr 15 \n(14
+.ds 15 \v'60u'\h'\n(15u-\n(13u/2u'\s7\*(13\s10\h'-\n(15u-\n(13u/2u'\v'-60u'\
+\h'\n(15u-\n(12u/2u'\*(12\h'\n(15u-\n(12u/2u'\
+\v'-66u'\h'-\n(15u-\n(14u/2u'\s7\*(14\s10\h'\n(15u-\n(14u/2u'\v'66u'\
+
+.as 11 "\*(15
+.nr 11 \w'\*(11'
+.ds 12 "\|\fR(\fP
+.nr 12 \w'\*(12'
+.as 11 "\*(12
+.nr 11 \w'\*(11'
+.ds 12 "x
+.nr 12 \w'\*(12'
+.ps 8
+.ds 13 "i
+.nr 13 \w'\*(13'
+.as 12 \v'18u'\s8\*(13\|\s10\v'-18u'
+.ps 10
+.nr 12 \n(12+\n(13+\w'\s8\|'
+.as 11 "\*(12
+.nr 11 \w'\*(11'
+.ds 12 "\|\(mi\|
+.nr 12 \w'\*(12'
+.as 11 "\*(12
+.nr 11 \w'\*(11'
+.ds 12 "x
+.nr 12 \w'\*(12'
+.nr 12 \w'\*(12'
+.nr 10 0
+.if \n(ct-1 .nr 10 .25m
+.nr 14 .15m
+.if 2-\n(ct .nr 14 .1m
+.ds 13 \v'.15m'\l'\n(12u\(rn'\v'-.15m'
+.nr 13 \w'\*(13'
+.as 12 \h'-\n(12u-\n(13u/2u+\n(14u'\v'0-\n(10u'\*(13\v'\n(10u'\h'-\n(13u+\n(12u/2u-\n(14u'
+.as 11 "\*(12
+.nr 11 \w'\*(11'
+.ds 12 "\|\fR)\fP
+.nr 12 \w'\*(12'
+.ps 8
+.ds 13 "\fR2\fP
+.nr 13 \w'\*(13'
+.as 12 \v'-24u'\s8\|\*(13\s10\v'24u'
+.ps 10
+.nr 12 \n(12+\n(13+\w'\s8\|'
+.as 11 "\*(12
+.nr 11 \w'\*(11'
+.ds 11 \x'0'\x'0-30u'\fI\s10\*(11\s\n(99\f\n(98\x'42u'
+.if \n(11-\n(.l .tm too-long eqn, file junk, between lines 2-4
+.if 168-\n(.v .ne 168u
+\*(11
+.ps \n(99
+.ft \n(98
+.EN
+.br
+.op
+Automatic calculation of size changes for subscripts, sub-subscripts,
+etc.
+.op
+Full vocabulary of Greek letters, such as `gamma', `GAMMA'.
+.op
+Automatic calculation of large bracket sizes.
+.op
+Vertical \*(lqpiling\*(rq of formulae for matrices, conditional
+alternatives, etc.
+.op
+Integrals, sums, etc. with arbitrarily complex limits.
+.op
+Diacriticals: dots, double dots, hats, bars.
+.op
+Easily learned by nonprogrammers and mathematical typists.
+.op
+Usable as a filter.
+.sh Manual
+Printed manual for EQN.
+.sh NEQN
+A mathematical typesetting preprocessor for NROFF.
+Prepares formulas for display on
+Model 37 Teletypes with half-line functions
+and 128-character font.
+.op
+For Diablo-mechanism terminals, filter output through GSI.
+.op
+Same facilities as EQN within graphical capability of
+terminal.
+.sh TBL
+A preprocessor for NROFF/TROFF
+that translates simple descriptions of table layouts
+and contents into detailed typesetting instructions.
+.op
+Computes column widths.
+.op
+Handles left- and right-justified columns,
+centered columns and decimal-point
+alignment.
+.op
+Places column titles.
+.sh MS
+A standardized manuscript layout
+for use with NROFF/TROFF.
+.op
+Page numbers and draft dates.
+.op
+Cover sheet and title page.
+.op
+Automatically numbered subheads.
+.op
+Footnotes.
+.op
+Single or double column.
+.op
+Paragraphing, display and indentation.
+.op
+Numbered equations.
+.h0 "\na.\n+b U\s8NIX\s10 Programmer's Manual"
+.sh MAN
+Print specified manual section on your terminal.
+.sh Manual
+Machine-readable version of the U\s8NIX\s10 
+Programmer's Manual.
+.op
+System overview.
+.op
+All commands.
+.op
+All system calls.
+.op
+All subroutines in assembler, C and FORTRAN libraries.
+.op
+All devices and other special files.
+.op
+Formats of file system and kinds
+of files known to system software.
+.op
+Boot procedures.
+.sp
+.ti4i
+May, 1975
+.sp
+.in0
+* DEC, PDP and DECtape are registered trademarks of Digital
+Equipment Corporation.
+V\s8\OTRAX\s10 is a registered trademark of
+Vocal Interface Division, Federal Screw Works.
diff --git a/usr/doc/hel/junk b/usr/doc/hel/junk
new file mode 100644 (file)
index 0000000..f0c71c0
--- /dev/null
@@ -0,0 +1,15 @@
+.sh GSI
+Simulate Model 37 Teletype facilities on
+GSI-300, DASI and other Diablo-mechanism terminals.
+.op
+Gives half-line and reverse platen motions.
+.op
+Approximates Greek letters and other special characters
+by overstriking.
+.op
+Usable as a filter.
+.sh COL
+Canonicalize files with reverse line feeds
+for one-pass printing.
+.op
+Usable as a filter.