BSD 4_2 development

Work on file usr/man/man0/bfile
Work on file usr/man/man0/copyr
Work on file usr/man/man0/comm.sed
Work on file usr/man/man0/m1.sed
Work on file usr/man/man0/m2.sed
Work on file usr/man/man0/trref.sed
Work on file usr/man/man0/trman
Work on file usr/man/man1/at.1
Work on file usr/man/man1/bc.1
Work on file usr/man/man1/cal.1
Work on file usr/man/man1/pi.1
Work on file usr/man/man1/calendar.1
Work on file usr/man/man1/cb.1
Work on file usr/man/man1/cd.1
Work on file usr/man/man1/cmp.1
Work on file usr/man/man1/clear.1
Work on file usr/man/man1/colcrt.1
Work on file usr/man/man1/w.1
Work on file usr/man/man1/colrm.1
Work on file usr/man/man1/comm.1
Work on file usr/man/man1/crypt.1
Work on file usr/man/man1/dc.1
Work on file usr/man/man1/deroff.1

Synthesized-from: CSRG/cd1/4.2

diff --git a/usr/man/man0/bfile b/usr/man/man0/bfile
new file mode 100644 (file)
index 0000000..1301163
--- /dev/null
+++ b/usr/man/man0/bfile
@@ -0,0 +1 @@
+ +-\*,`():;/

diff --git a/usr/man/man0/comm.sed b/usr/man/man0/comm.sed
new file mode 100644 (file)
index 0000000..cc479e7
--- /dev/null
+++ b/usr/man/man0/comm.sed
@@ -0,0 +1,9 @@
+:x
+N
+/\( [^ ]*\)\n.*\1$/{
+       s/\n.*//
+       bx
+}
+P
+s/.*\n//
+bx

diff --git a/usr/man/man0/copyr b/usr/man/man0/copyr
new file mode 100644 (file)
index 0000000..3aa0fa6
--- /dev/null
+++ b/usr/man/man0/copyr
@@ -0,0 +1,14 @@
+...fp 3 G
+.ll 4.8i
+.in .75i
+.hy 0
+.vs 12p
+--
+.sp |8i
+Copyright 1979, Bell Telephone Laboratories, Incorporated.
+Holders of a UNIX\v'-4p'\s-2\fGTM\fP\s0\v'4p'/32V software
+license are permitted to copy this document, or any portion
+of it, as necessary for licensed use of the software,
+provided this copyright notice and statement of permission
+are included.
+.bp

diff --git a/usr/man/man0/m1.sed b/usr/man/man0/m1.sed
new file mode 100644 (file)
index 0000000..f1e9b86
--- /dev/null
+++ b/usr/man/man0/m1.sed
@@ -0,0 +1,90 @@
+:x
+s/``/`/g
+s/''/'/g
+s/\\\*-/\\-/g
+s/\\\*a/\\'/g
+s/\\\*g/\\`/g
+s/\\\*_/_/g
+s/\\\*v/\\(bv/g
+s/\\\*X/\\(mu/g
+s/\\\*>/\\(->/g
+s/\\\*b/\\(*b/g
+s/\\\*p/\\(*p/g
+s/\\\*G/\\(*G/g
+s/\\\*r/\\*R/g
+s/\\\*u/\\(*m/g
+/^\.li/{
+       N
+       p
+       d
+}
+s/^\.dt/.DT/
+s/^\.th/.TH/
+s/^\.sh/.SH/
+s/^\.it/.I/
+s/^\.bd/.B/
+s/^\.Bd/.bd/
+/^\.lp/{
+       s/.lp/.br\
+.ns\
+.Lp/
+       P
+       D
+}
+/^\.s[123]/{
+       N
+       /\n\.i0/s/.*/.PP/
+       /\n\.lp/s/.*\n//
+       /s[123]/{
+               s//DP/
+               P
+               D
+       }
+}
+/^\.i0/{
+       N
+       /\.s[123]/s/.*/.PP/
+       s/.i0.*\n//
+}
+s/^\.Lp/.lp/
+/^\.lp/{
+       / *0 *$/{
+               s///
+               s/lp *+/IP "" /
+               p
+               d
+       }
+       s/ *+/ /
+       s/ *[^ ]* *$//
+       N
+       /       /!{
+               s/lp/HP/
+       }
+       s/^.lp/.TP/
+       s/      /\
+/
+       P
+       D
+}
+/^\.I *[^ ]*$/{
+       N
+       s/^.I\(.*\)\n\(([IVX][ALMIVXSZ]*)[^ ]*\) */.IR \1 \2\
+/
+       s/\n$//
+       P
+       D
+}
+s/ \(([IVX][ALMIVXSZ]*)\)/\1/g
+/^\\f/{
+       s/\\f/@/g
+       s/@P/@R/g
+       s/^@\(.\)\([^@\n]*\)@\(.\)\([^@\n]*\)@\1\([^\n]*\)/.\1\3 "\2" "\4" "\5"/
+       s/^@\(.\)\([^@\n]*\)@\(.\)\([^\n]*\)/.\1\3 "\2" "\4"/
+       s/^@\(.\)\([^\n]*\)/.\1 "\2"/
+       s/@R"$/"/
+       s/@R"\n/"\
+/
+       s/@/\\f/g
+}
+P
+D

diff --git a/usr/man/man0/m2.sed b/usr/man/man0/m2.sed
new file mode 100644 (file)
index 0000000..1eaec82
--- /dev/null
+++ b/usr/man/man0/m2.sed
@@ -0,0 +1,27 @@
+/^[^.].*\\f/{
+       s/\\f/@/g
+       s/@P/@R/g
+       s/ @\(.\)\([^@]*\)@R\([^ @]*\)  */\
+.\1R "\2" "\3"\
+/
+       s/ @\(.\)\([^@]*\)@R\([^ @]*\) *$/\
+.\1R "\2" "\3"/
+       s/@\(.\) \([^@]*\)@R\([^ @]*\)  */\
+.\1R "\2" "\3"\
+/
+       s/@\(.\) \([^@]*\)@R\([^ @]*\) *$/\
+.\1R "\2" "\3"/
+       s/@/\\f/g
+}
+/^\.[TH]P/,/^\.PP/s/^\.DP/.IP/
+s/^\.DP/.PP/
+/^\.[BIR][BIR]/s/[ ]*""$//
+/^\.\([BIR]\)[BIR][^"]*"[^"]*"$/s/.\(.\)./.\1 /
+:x
+/^\.[^"]*"[^"  ][^"    ]*"/{
+       s/"//
+       s///
+       bx
+}
+P
+D

diff --git a/usr/man/man0/trman b/usr/man/man0/trman
new file mode 100644 (file)
index 0000000..0060e5b
--- /dev/null
+++ b/usr/man/man0/trman
@@ -0,0 +1,3 @@
+sed -n -f /usr/man/man0/m1.sed $1\
+|sed -n -f /usr/man/man0/m2.sed \
+|sed -f /usr/man/man0/trref.sed

diff --git a/usr/man/man0/trref.sed b/usr/man/man0/trref.sed
new file mode 100644 (file)
index 0000000..c437994
--- /dev/null
+++ b/usr/man/man0/trref.sed
@@ -0,0 +1,49 @@
+/^\.TH/{
+       s/ I / 1 /
+       s/ IL / 1 local /
+       s/ IC / 1C /
+       s/ ICL / 1C local /
+       s/ ID / 1D /
+       s/ IG / 1G /
+       s/ IGL / 1G local /
+       s/ IM / 1M /
+       s/ II / 2 /
+       s/ III / 3Z /
+       s/ IIIA / 3A /
+       s/ IIIF / 3F /
+       s/ IIIS / 3S /
+       s/ IIIZ / 3Z /
+       s/ IV / 4 /
+       s/ IVH / 9 /
+       s/ IVT / 7 /
+       s/ V / 5 /
+       s/ VI / 1 /
+       s/ VII / 3 /
+       s/ VIII / 8 /
+       /local/{
+               s///
+               s/$/ local/
+       }
+}
+s/(I)/(1)/g
+s/(IC)/(1)/g
+s/(ID)/(1)/g
+s/(IG)/(1)/g
+s/(IM)/(1)/g
+s/(II)/(2)/g
+s/(III)/(3)/g
+s/(IIIA)/(3)/g
+s/(IIIF)/(3)/g
+s/(IIIS)/(3)/g
+s/(IIIZ)/(3)/g
+s/(IV)/(4)/g
+s/(IVH)/(9)/g
+s/(IVT)/(7)/g
+s/(V)/(5)/g
+s/(VI)/(1)/g
+s/(VII)/(3)/g
+s/(VIII)/(8)/g
+/SEE/,/SH/s/  *(/(/g
+${
+       /BUG/d
+}

diff --git a/usr/man/man1/at.1 b/usr/man/man1/at.1
new file mode 100644 (file)
index 0000000..9287525
--- /dev/null
+++ b/usr/man/man1/at.1
@@ -0,0 +1,94 @@
+.TH AT 1 "18 January 1983"
+.UC 4
+.SH NAME
+at \- execute commands at a later time
+.SH SYNOPSIS
+.B at
+time
+[
+day
+]
+[
+file
+]
+.SH DESCRIPTION
+.I At
+squirrels away a copy of the named
+.I file
+(standard input default)
+to be used as input to
+.IR sh (1)
+(or
+.IR csh (1)
+if you normally use it)
+at a specified later time.
+A
+.I cd
+command to the current directory is inserted
+at the beginning,
+followed by assignments to all environment variables (excepting the
+variable TERM, which is useless in this context.)
+When the script is run, it uses the user and group ID
+of the creator of the copy file.
+.PP
+The
+.I time
+is 1 to 4 digits, with an optional following
+`A', `P', `N' or `M' for
+AM, PM, noon or midnight.
+One and two digit numbers are taken to be hours, three and four digits
+to be hours and minutes.
+If no letters follow the digits, a 24 hour clock time is understood.
+.PP
+The optional
+.I day
+is either
+(1) a month name followed by a day number,
+or
+(2) a day of the week; if the word `week' follows
+invocation is moved seven days further off.
+Names of months and days may be recognizably truncated.
+Examples of legitimate commands are
+.IP
+at 8am jan 24
+.br
+at 1530 fr week
+.PP
+.I At
+programs are executed by periodic execution
+of the command
+.I /usr/lib/atrun
+from
+.IR cron (8).
+The granularity of
+.I at
+depends upon how often
+.I atrun
+is executed.
+.PP
+Standard output or error output is lost unless redirected.
+.SH FILES
+.ta 2i
+/usr/lib/atrun executor (run by 
+.IR cron (8)).
+.sp
+in /usr/spool/at:
+.ta .5i 2i
+.br
+\&     yy.ddd.hhhh.*   activity for year yy, day dd, hour hhhh.
+.br
+\&     lasttimedone    last \fIhhhh\fR
+.br
+\&     past    activities in progress
+.SH "SEE ALSO"
+calendar(1),
+pwd(1),
+sleep(1),
+cron(8)
+.SH DIAGNOSTICS
+Complains about various syntax errors and times out of range.
+.SH BUGS
+Due to the granularity of the execution of
+.I /usr/lib/atrun,
+there may be bugs in scheduling things almost
+exactly 24 hours into the future.

diff --git a/usr/man/man1/bc.1 b/usr/man/man1/bc.1
new file mode 100644 (file)
index 0000000..72f0865
--- /dev/null
+++ b/usr/man/man1/bc.1
@@ -0,0 +1,193 @@
+.TH BC 1 "1 April 1981"
+.SH NAME
+bc \- arbitrary-precision arithmetic language
+.SH SYNOPSIS
+.B bc
+[
+.B \-c
+] [
+.B \-l
+] [ file ... ]
+.SH DESCRIPTION
+.I Bc
+is an interactive processor for a language which resembles
+C but provides unlimited precision arithmetic.
+It takes input from any files given, then reads
+the standard input.
+The
+.B \-l
+argument stands for the name
+of an arbitrary precision math library.
+The syntax for 
+.I bc
+programs is as follows;
+L means letter a-z,
+E means expression, S means statement.
+.HP 6
+Comments
+.br
+are enclosed in /* and */.
+.HP 6
+Names
+.br
+simple variables: L
+.br
+array elements: L [ E ]
+.br
+The words `ibase', `obase', and `scale'
+.HP 6
+Other operands
+.br
+arbitrarily long numbers with optional sign and decimal point.
+.br
+( E )
+.br
+sqrt ( E )
+.br
+length ( E )   number of significant decimal digits
+.br
+scale ( E )    number of digits right of decimal point
+.br
+L ( E , ... , E )
+.HP 6
+Operators
+.br
++  \-  *  /  %  ^
+(% is remainder; ^ is power)
+.br
+++   \-\-         (prefix and postfix; apply to names)
+.br
+==  <=  >=  !=  <  >
+.br
+=  +=  \-=  *=  /=  %=  ^=
+.br
+.HP 6
+Statements
+.br
+E
+.br
+{ S ; ... ; S }
+.br
+if ( E ) S
+.br
+while ( E ) S
+.br
+for ( E ; E ; E ) S
+.br
+null statement
+.br
+break
+.br
+quit
+.HP 6
+Function definitions
+.br
+define L ( L ,..., L ) {
+.br
+       auto L, ... , L
+.br
+       S; ... S
+.br
+       return ( E )
+.br
+}
+.HP 6
+Functions in 
+.B \-l
+math library
+.br
+s(x)   sine
+.br
+c(x)   cosine
+.br
+e(x)   exponential
+.br
+l(x)   log
+.br
+a(x)   arctangent
+.br
+j(n,x) Bessel function
+.PP
+.DT
+All function arguments are passed by value.
+.PP
+The value of a statement that is an expression is printed
+unless the main operator is an assignment.
+Either semicolons or newlines may separate statements.
+Assignment to
+.I scale
+influences the number of digits to be retained on arithmetic
+operations in the manner of
+.IR dc (1).
+Assignments to
+.I ibase
+or
+.I obase
+set the input and output number radix respectively.
+.PP
+The same letter may be used as an array, a function,
+and a simple variable simultaneously.
+All variables are global to the program.
+`Auto' variables are pushed down during function calls.
+When using arrays as function arguments
+or defining them as automatic variables
+empty square brackets must follow the array name.
+.PP
+For example
+.PP
+.nf
+scale = 20
+define e(x){
+       auto a, b, c, i, s
+       a = 1
+       b = 1
+       s = 1
+       for(i=1; 1==1; i++){
+               a = a*x
+               b = b*i
+               c = a/b
+               if(c == 0) return(s)
+               s = s+c
+       }
+}
+.PP
+.fi
+defines a function to compute an approximate value of
+the exponential function and
+.PP
+.nf
+       for(i=1; i<=10; i++) e(i)
+.fi
+.PP
+prints approximate values of the exponential function of
+the first ten integers.
+.PP
+.I Bc
+is actually a preprocessor for
+.IR dc (1),
+which it invokes automatically, unless the
+.B \-c
+(compile only)
+option is present.
+In this case the
+.I dc
+input is sent to the standard output instead.
+.SH FILES
+.ta \w'/usr/lib/lib.b 'u
+/usr/lib/lib.b mathematical library
+.br
+dc(1)  desk calculator proper
+.SH "SEE ALSO"
+dc(1)
+.br
+L. L. Cherry and R. Morris,
+.I
+BC \- An arbitrary precision desk-calculator language
+.SH BUGS
+No &&, \(or\|\(or, or ! operators.
+.br
+.I For
+statement must have all three E's.
+.br
+.I \11\11Quit
+is interpreted when read, not when executed.

diff --git a/usr/man/man1/cal.1 b/usr/man/man1/cal.1
new file mode 100644 (file)
index 0000000..5a064f4
--- /dev/null
+++ b/usr/man/man1/cal.1
@@ -0,0 +1,27 @@
+.TH CAL 1 "29 March 1982"
+.SH NAME
+cal \- print calendar
+.SH SYNOPSIS
+.B cal
+[ month ] year
+.SH DESCRIPTION
+.I Cal
+prints a calendar for the specified year.
+If a month is also specified, a calendar
+just for that month is printed.
+.I Year
+can be between 1
+and 9999.
+The
+.I month
+is a number between 1 and 12.
+The calendar
+produced is that for England and her colonies.
+.PP
+Try September 1752.
+.SH BUGS
+The year is always considered to start in January even though this
+is historically naive.
+.br
+Beware that `cal 78' refers to the early Christian era,
+not the 20th century.

diff --git a/usr/man/man1/calendar.1 b/usr/man/man1/calendar.1
new file mode 100644 (file)
index 0000000..b4f7ee3
--- /dev/null
+++ b/usr/man/man1/calendar.1
@@ -0,0 +1,51 @@
+.TH CALENDAR 1  "29 March 1982"
+.UC 4.2 Provisional
+.SH NAME
+calendar \- reminder service
+.SH SYNOPSIS
+.B calendar
+[ \- ]
+.SH DESCRIPTION
+.I Calendar 
+consults the file `calendar' in the current directory
+and prints out lines that contain today's or
+tomorrow's date anywhere in the line.
+Most reasonable month-day dates such as `Dec. 7,'
+`december 7,' `12/7,' etc., are recognized, but not
+`7 December' or `7/12'.
+If you give the month as ``*''
+with a date, i.e. ``* 1'', that day in any month will do.
+On weekends `tomorrow' extends through Monday.
+.PP
+When 
+an argument is present,
+.I calendar
+does its job for every user
+who has a file `calendar' in his login directory
+and sends him any positive results by
+.IR mail (1).
+Normally this is done daily in the wee hours under control of
+.IR cron (8).
+.PP
+The file `calendar' is first run through the ``C'' preprocessor,
+.IR /lib/cpp ,
+to include any other calendar files
+specified with the usual ``#include'' syntax.
+Included calendars will usually be shared by all users,
+maintained and documented by the local administration.
+.SH FILES
+calendar
+.br
+/usr/lib/calendar to figure out today's and tomorrow's dates
+.br
+/etc/passwd
+.br
+/tmp/cal*
+.br
+/lib/cpp, egrep, sed, mail as subprocesses
+.SH "SEE ALSO"
+at(1), cron(8), mail(1)
+.SH BUGS
+.I Calendar's
+extended idea of `tomorrow' doesn't account for
+holidays.

diff --git a/usr/man/man1/cb.1 b/usr/man/man1/cb.1
new file mode 100644 (file)
index 0000000..7e6c44b
--- /dev/null
+++ b/usr/man/man1/cb.1
@@ -0,0 +1,10 @@
+.TH CB 1 "18 January 1983"
+.SH NAME
+cb \- C program beautifier
+.SH SYNOPSIS
+.B cb
+.SH DESCRIPTION
+.I Cb
+places a copy of the C program from the standard input
+on the standard output with spacing and indentation
+that displays the structure of the program.

diff --git a/usr/man/man1/cd.1 b/usr/man/man1/cd.1
new file mode 100644 (file)
index 0000000..ca60497
--- /dev/null
+++ b/usr/man/man1/cd.1
@@ -0,0 +1,31 @@
+.TH CD 1 "5 April 1980"
+.UC 4
+.SH NAME
+cd \- change working directory
+.SH SYNOPSIS
+.B cd
+directory
+.SH DESCRIPTION
+.I Directory
+becomes the new working directory.
+The process must have execute (search)
+permission in
+.IR directory .
+.PP
+Because a new process is created to execute each command,
+.I cd
+would be ineffective if it were written as a
+normal command.  It is therefore recognized and executed
+by the shells.
+In
+.IR csh (1)
+you may specify a list of directories in which
+.I directory
+is to be sought as a subdirectory if it is not
+a subdirectory of the current directory;
+see the description of the
+.I cdpath
+variable in
+.IR csh (1).
+.SH "SEE ALSO"
+csh(1), sh(1), pwd(1), chdir(2)

diff --git a/usr/man/man1/clear.1 b/usr/man/man1/clear.1
new file mode 100644 (file)
index 0000000..75f772c
--- /dev/null
+++ b/usr/man/man1/clear.1
@@ -0,0 +1,14 @@
+.TH CLEAR 1 "24 February 1979"
+.UC
+.SH NAME
+clear \- clear terminal screen
+.SH SYNOPSIS
+.B clear
+.SH DESCRIPTION
+.I Clear
+clears your screen if this is possible.
+It looks in the environment for the terminal type and then in
+.I /etc/termcap
+to figure out how to clear the screen.
+.SH FILES
+/etc/termcap   terminal capability data base

diff --git a/usr/man/man1/cmp.1 b/usr/man/man1/cmp.1
new file mode 100644 (file)
index 0000000..ce7389b
--- /dev/null
+++ b/usr/man/man1/cmp.1
@@ -0,0 +1,42 @@
+.TH CMP 1 "18 January 1983"
+.SH NAME
+cmp \- compare two files
+.SH SYNOPSIS
+.B cmp
+[
+.B \-l
+] [
+.B \-s
+]
+file1 file2
+.SH DESCRIPTION
+The two files are
+compared.
+(If
+.I file1
+is `\-',
+the standard input is used.)
+Under default options,
+.I cmp
+makes no comment if the files are the same;
+if they differ, it announces the byte and line number
+at which the difference occurred.
+If one file is an initial subsequence
+of the other, that fact is noted.
+.PP
+Options:
+.TP 6
+.B  \-l
+Print the byte number (decimal) and the
+differing bytes (octal) for each difference.
+.TP 6
+.B  \-s
+Print nothing for differing files;
+return codes only.
+.dt
+.SH "SEE ALSO"
+diff(1), comm(1)
+.SH DIAGNOSTICS
+Exit code 0 is returned for identical
+files, 1 for different files, and 2 for an
+inaccessible or missing argument.

diff --git a/usr/man/man1/colcrt.1 b/usr/man/man1/colcrt.1
new file mode 100644 (file)
index 0000000..913c486
--- /dev/null
+++ b/usr/man/man1/colcrt.1
@@ -0,0 +1,70 @@
+.TH COLCRT 1 "24 February 1979"
+.UC
+.SH NAME
+colcrt \- filter nroff output for CRT previewing
+.SH SYNOPSIS
+.B colcrt
+[
+.B \-
+] [
+.B \-2
+] [
+file ...
+]
+.SH DESCRIPTION
+.I Colcrt
+provides virtual half-line and reverse line feed sequences
+for terminals without such capability, and on which overstriking
+is destructive.
+Half-line characters and underlining (changed to dashing `\-')
+are placed on new lines in between the normal output lines.
+.PP
+The optional
+.B \- 
+suppresses all underlining.
+It is especially useful for previewing
+.I allboxed
+tables from
+.IR  tbl (1).
+.PP
+The option
+.B \-2
+causes all half-lines to be printed, effectively double spacing the output.
+Normally, a minimal space output format is used which will suppress empty
+lines.
+The program never suppresses two consecutive empty lines, however.
+The
+.B \-2
+option is useful for sending output to the line printer when the output
+contains superscripts and subscripts which would otherwise be invisible.
+.PP
+A typical use of
+.I colcrt
+would be
+.PP
+.DT
+       tbl exum2.n | nroff \-ms | colcrt \- | more
+.SH "SEE ALSO"
+nroff/troff(1), col(1), more(1), ul(1)
+.SH AUTHOR
+William Joy
+.SH BUGS
+Should fold underlines onto blanks even with the
+`\fB\-\fR'
+option so that
+a true underline character would show; if we did this, however,
+.I colcrt
+wouldn't get rid of
+.I cu'd
+underlining
+completely.
+.PP
+Can't back up more than 102 lines.
+.PP
+General overstriking is lost;
+as a special case `|' overstruck with `\-' or underline becomes `+'.
+.PP
+Lines are trimmed to 132 characters.
+.PP
+Some provision should be made for processing superscripts and subscripts
+in documents which are already double-spaced.

diff --git a/usr/man/man1/colrm.1 b/usr/man/man1/colrm.1
new file mode 100644 (file)
index 0000000..a6a6ac1
--- /dev/null
+++ b/usr/man/man1/colrm.1
@@ -0,0 +1,27 @@
+.TH COLRM 1 "18 January 1983"
+.UC 4
+.SH NAME
+colrm \- remove columns from a file
+.SH SYNOPSIS
+.B colrm
+[
+startcol
+[
+endcol
+]
+]
+.SH DESCRIPTION
+.I Colrm
+removes selected columns from a file.  Input is taken from standard input.
+Output is sent to standard output.
+.PP
+If called with one parameter the columns
+of each line will be removed starting with the specified column.
+If called with two parameters the columns from the first column
+to the last column will be removed.
+.PP
+Column numbering starts with column 1.
+.SH "SEE ALSO"
+expand(1)
+.SH AUTHOR
+Jeff Schriebman

diff --git a/usr/man/man1/comm.1 b/usr/man/man1/comm.1
new file mode 100644 (file)
index 0000000..e7dc65c
--- /dev/null
+++ b/usr/man/man1/comm.1
@@ -0,0 +1,40 @@
+.TH COMM 1  "18 January 1983"
+.SH NAME
+comm \- select or reject lines common to two sorted files
+.SH SYNOPSIS
+.B comm
+[
+.B \-
+[
+.B 123
+]
+] file1 file2
+.SH DESCRIPTION
+.I Comm
+reads
+.I file1
+and
+.I file2,
+which should be ordered in ASCII collating sequence,
+and produces a three column output: lines only in
+.I file1;
+lines only in
+.I file2;
+and lines in both files.
+The filename `\-' means the standard input.
+.PP
+Flags 1, 2, or 3 suppress printing of the corresponding
+column.
+Thus
+.B comm
+.B \-12
+prints only the lines common to the two files;
+.B comm
+.B \-23
+prints only lines in the first file but not in the second;
+.B comm
+.B \-123
+is a no-op.
+.PP
+.SH "SEE ALSO"
+cmp(1), diff(1), uniq(1)

diff --git a/usr/man/man1/crypt.1 b/usr/man/man1/crypt.1
new file mode 100644 (file)
index 0000000..8372150
--- /dev/null
+++ b/usr/man/man1/crypt.1
@@ -0,0 +1,85 @@
+.TH CRYPT 1 "18 January 1983"
+.SH NAME
+crypt \- encode/decode
+.SH SYNOPSIS
+.B crypt
+[ password ]
+.SH DESCRIPTION
+.I Crypt
+reads from the standard input and writes
+on the standard output.
+The
+.I password
+is a key that selects a particular transformation.
+If no
+.I password 
+is given,
+.I crypt
+demands a key from the terminal and turns
+off printing while the key is being typed in.
+.I Crypt
+encrypts and decrypts with the same key:
+.PP
+       crypt key <clear >cypher
+.br
+       crypt key <cypher | pr
+.PP
+will print the clear.
+.PP
+Files encrypted by
+.I crypt
+are compatible with those treated by the editor
+.I ed
+in encryption mode.
+.PP
+The security of encrypted files depends on three factors:
+the fundamental method must be hard to solve;
+direct search of the key space must be infeasible;
+`sneak paths' by which keys or cleartext can become
+visible must be minimized.
+.PP
+.I Crypt
+implements a one-rotor machine designed along the lines
+of the German Enigma, but with a 256-element rotor.
+Methods of attack on such machines are known, but not widely;
+moreover the amount of work required is likely to be large.
+.PP
+The transformation of a key into the internal
+settings of the machine is deliberately designed to
+be expensive, i.e. to take a substantial fraction of
+a second to compute.
+However,
+if keys are restricted to (say)
+three lower-case letters,
+then encrypted files can be read by expending only
+a substantial fraction of
+five minutes of machine time.
+.PP
+Since the key is an argument to the
+.I crypt
+command,
+it is potentially visible to users executing
+.IR ps (1)
+or a derivative.
+To minimize this possibility,
+.I crypt
+takes care to destroy any record of the key
+immediately upon entry.
+No doubt the choice of keys and key security
+are the most vulnerable aspect of
+.I crypt.
+.SH FILES
+/dev/tty for typed key
+.SH "SEE ALSO"
+ed(1),
+makekey(8)
+.SH BUGS
+There is no warranty of merchantability nor any warranty
+of fitness for a particular purpose nor any other warranty,
+either express or implied, as to the accuracy of the
+enclosed materials or as to their suitability for any
+particular purpose.  Accordingly, Bell Telephone
+Laboratories assumes no responsibility for their use by the
+recipient.   Further, Bell Laboratories assumes no obligation
+to furnish any assistance of any kind whatsoever, or to
+furnish any additional information or documentation.

diff --git a/usr/man/man1/dc.1 b/usr/man/man1/dc.1
new file mode 100644 (file)
index 0000000..6798fdf
--- /dev/null
+++ b/usr/man/man1/dc.1
@@ -0,0 +1,198 @@
+.TH DC 1  "18 January 1983"
+.SH NAME
+dc \- desk calculator
+.SH SYNOPSIS
+.B dc
+[ file ]
+.SH DESCRIPTION
+.I Dc
+is an arbitrary precision arithmetic package.
+Ordinarily it operates on decimal integers,
+but one may specify an input base, output base,
+and a number of fractional digits to be maintained.
+The overall structure of
+.I dc
+is
+a stacking (reverse Polish) calculator.
+If an argument is given,
+input is taken from that file until its end,
+then from the standard input.
+The following constructions are recognized:
+.HP 6
+number
+.br
+The value of the number is pushed on the stack.
+A number is an unbroken string of the digits 0-9.
+It may be preceded by an underscore _ to input a
+negative number.
+Numbers may contain decimal points.
+.HP 6
++  \- /  *  %  ^
+.br
+The
+top two values on the stack are added
+(+),
+subtracted
+(\-),
+multiplied (*),
+divided (/),
+remaindered (%),
+or exponentiated (^).
+The two entries are popped off the stack;
+the result is pushed on the stack in their place.
+Any fractional part of an exponent is ignored.
+.TP
+.BI s x
+The
+top of the stack is popped and stored into
+a register named
+.I x,
+where
+.I x
+may be any character.
+If
+the
+.B s
+is capitalized,
+.I x
+is treated as a stack and the value is pushed on it.
+.TP
+.BI l x
+The
+value in register
+.I x
+is pushed on the stack.
+The register
+.I x
+is not altered.
+All registers start with zero value.
+If the
+.B l
+is capitalized,
+register
+.I x
+is treated as a stack and its top value is popped onto the main stack.
+.TP
+.B  d
+The
+top value on the stack is duplicated.
+.TP
+.B  p
+The top value on the stack is printed.
+The top value remains unchanged.
+.B P
+interprets the top of the stack as an ascii string,
+removes it, and prints it.
+.TP
+.B  f
+All values on the stack and in registers are printed.
+.TP
+.B  q
+exits the program.
+If executing a string, the recursion level is
+popped by two.
+If
+.B q
+is capitalized,
+the top value on the stack is popped and the string execution level is popped
+by that value.
+.TP
+.B  x
+treats the top element of the stack as a character string
+and executes it as a string of dc commands.
+.TP
+.B  X
+replaces the number on the top of the stack with its scale factor.
+.TP
+.B  "[ ... ]"
+puts the bracketed ascii string onto the top of the stack.
+.HP 6
+.I  "<x  >x  =x"
+.br
+The
+top two elements of the stack are popped and compared.
+Register
+.I x
+is executed if they obey the stated
+relation.
+.TP
+.B  v
+replaces the top element on the stack by its square root.
+Any existing fractional part of the argument is taken
+into account, but otherwise the scale factor is ignored.
+.TP
+.B  !
+interprets the rest of the line as a UNIX command.
+.TP
+.B  c
+All values on the stack are popped.
+.TP
+.B  i
+The top value on the stack is popped and used as the
+number radix for further input.
+.B I
+pushes the input base on the top of the stack.
+.TP
+.B  o
+The top value on the stack is popped and used as the
+number radix for further output.
+.TP
+.SM
+.B O
+pushes the output base on the top of the stack.
+.TP
+.B  k
+the top of the stack is popped, and that value is used as
+a non-negative scale factor:
+the appropriate number of places
+are printed on output,
+and maintained during multiplication, division, and exponentiation.
+The interaction of scale factor,
+input base, and output base will be reasonable if all are changed
+together.
+.TP
+.B  z
+The stack level is pushed onto the stack.
+.TP
+.SM
+.B  Z
+replaces the number on the top of the stack with its length.
+.TP
+.B  ?
+A line of input is taken from the input source (usually the terminal)
+and executed.
+.TP
+.B "; :"
+are used by 
+.I bc
+for array operations.
+.PP
+An example which prints the first ten values of n! is
+.nf
+.PP
+.in +3
+[la1+dsa*pla10>y]sy
+.br
+0sa1
+.br
+lyx
+.fi
+.SH "SEE ALSO"
+bc(1),
+which is a preprocessor for
+.I dc
+providing infix notation and a C-like syntax
+which implements functions and reasonable control
+structures for programs.
+.SH DIAGNOSTICS
+`x is unimplemented' where x is an octal number.
+.br
+`stack empty' for not enough elements on the stack to do what was asked.
+.br
+`Out of space' when the free list is exhausted (too many digits).
+.br
+`Out of headers' for too many numbers being kept around.
+.br
+`Out of pushdown' for too many items on the stack.
+.br
+`Nesting Depth' for too many levels of nested execution.

diff --git a/usr/man/man1/deroff.1 b/usr/man/man1/deroff.1
new file mode 100644 (file)
index 0000000..7811840
--- /dev/null
+++ b/usr/man/man1/deroff.1
@@ -0,0 +1,40 @@
+.TH DEROFF 1  "18 January 1983"
+.SH NAME
+deroff \- remove nroff, troff, tbl and eqn constructs
+.SH SYNOPSIS
+.B deroff
+[
+.B \-w
+]
+file ...
+.SH DESCRIPTION
+.I Deroff
+reads each file in sequence and removes all
+.I nroff
+and
+.I troff
+command lines, backslash constructions, macro definitions,
+.I eqn
+constructs (between `.EQ' and `.EN' lines or between delimiters),
+and table descriptions and writes the remainder on the standard output.
+.I Deroff
+follows chains of included files (`.so' and `.nx' commands);
+if a file has already been included, a `.so' is ignored and a `.nx'
+terminates execution.  If no input file is given,
+.I deroff
+reads from the standard input file.
+.PP
+If the
+.B \-w
+flag is given, the output is a word list, one `word' (string of letters,
+digits, and apostrophes, beginning with a letter; apostrophes are removed)
+per line, and all other characters ignored.
+Otherwise, the output follows the original, with the deletions mentioned above.
+.SH "SEE ALSO"
+troff(1), eqn(1), tbl(1)
+.SH BUGS
+.I Deroff
+is not a complete
+.I troff
+interpreter, so it can be confused by subtle constructs.
+Most errors result in too much rather than too little output.

diff --git a/usr/man/man1/pi.1 b/usr/man/man1/pi.1
new file mode 100644 (file)
index 0000000..2781f1e
--- /dev/null
+++ b/usr/man/man1/pi.1
@@ -0,0 +1,155 @@
+.TH PI 1 "8 April 1979"
+.UC
+.SH NAME
+pi \- Pascal interpreter code translator
+.SH SYNOPSIS
+.B pi
+[
+.B option
+] [
+.B \-i
+name ...
+] name.p
+.SH DESCRIPTION
+.I Pi
+translates the program in the file
+.I name.p
+leaving interpreter code in the file
+.I obj
+in the current directory.
+The interpreter code can be executed using
+.I px.
+.I Pix
+performs the functions of
+.I pi
+and
+.I px
+for `load and go' Pascal.
+.PP
+The following flags are interpreted by 
+.I pi;
+the associated options can also be controlled in comments within the program
+as described in the
+.I "Berkeley Pascal User's Manual."
+.TP 6
+.B  \-b
+Block buffer the file
+.I output.
+.TP 6
+.B  \-i
+Enable the listing for
+any specified procedures and functions and while processing any specified
+.B include
+files.
+.TP 6
+.B  \-l
+Make a program listing during translation.
+.TP 6
+.B  \-n
+Begin each listed
+.B include
+file on a new page with a banner line.
+.TP 6
+.B  \-p
+Suppress the post-mortem control flow backtrace
+if an error occurs;
+suppress statement limit counting.
+.TP 6
+.B  \-s
+Accept standard Pascal only;
+non-standard constructs cause warning diagnostics.
+.TP 6
+.B  \-t
+Suppress runtime tests of subrange variables and treat
+.B assert
+statements as comments.
+.TP 6
+.B  \-u
+Card image mode;
+only the first 72 characters of input lines are used.
+.TP 6
+.B  \-w
+Suppress warning diagnostics.
+.TP 6
+.B  \-z
+Allow execution profiling with
+.I pxp
+by generating statement counters, and arranging for the
+creation of the profile data file
+.I pmon.out
+when the resulting object is executed.
+.dt
+.SH FILES
+file.p                         input file
+.br
+file.i                         \fBinclude\fR file(s)
+.br
+/usr/lib/pi2.*strings          text of the error messages
+.br
+.nf
+/usr/lib/how_pi*               basic usage explanation
+.fi
+obj                            interpreter code output
+.SH "SEE ALSO"
+Berkeley Pascal User's Manual
+.br
+pix(1),
+px(1),
+pxp(1),
+pxref(1)
+.SH DIAGNOSTICS
+For a basic explanation do
+.IP
+.B     pi
+.PP
+In the diagnostic output of the translator,
+lines containing syntax errors are listed with a flag indicating the
+point of error.
+Diagnostic messages indicate the action which the recovery mechanism
+took in order to be able to continue parsing.
+Some diagnostics indicate only that the input is `malformed.'
+This occurs if the recovery can find no simple correction to make the input
+syntactically valid.
+.LP
+Semantic error diagnostics indicate a line in the source text near the
+point of error.
+Some errors evoke more than one diagnostic to help pinpoint the error;
+the follow-up messages begin with an ellipsis `...'.
+.LP
+.ne 8
+The first character of each error message indicates its class:
+.LP
+.ta 1ic 2.i
+       E       Fatal error; no code will be generated.
+.br
+       e       Non-fatal error.
+.br
+       w       Warning \- a potential problem.
+.br
+       s       Non-standard Pascal construct warning.
+.LP
+If a severe error occurs which inhibits further processing,
+the translator will give a diagnostic and then `QUIT'.
+.SH AUTHORS
+Charles B. Haley, William N. Joy, and Ken Thompson
+.br
+Ported to VAX-11 by Peter Kessler
+.SH BUGS
+The keyword
+.B packed
+is recognized but has no effect.
+.PP
+For clarity,
+semantic errors should be flagged at an appropriate place in the source text,
+and multiple instances of the `same' semantic error should be summarized
+at the end of a
+.B procedure
+or
+.B function
+rather than evoking many diagnostics.
+.PP
+When
+.B include
+files are present,
+diagnostics relating to the last procedure in one file may appear after the
+beginning of the listing of the next.

diff --git a/usr/man/man1/w.1 b/usr/man/man1/w.1
new file mode 100644 (file)
index 0000000..766d72a
--- /dev/null
+++ b/usr/man/man1/w.1
@@ -0,0 +1,83 @@
+.TH W 1 "15 August 1980"
+.UC 4
+.SH NAME
+w \- who is on and what they are doing
+.SH SYNOPSIS
+.B w
+[
+.B \-h
+] [
+.B \-s
+] [ user ]
+.SH DESCRIPTION
+.I W
+prints a summary of the current activity on the system,
+including what each user is doing.
+The heading line shows the current time of day,
+how long the system has been up,
+the number of users logged into the system,
+and the load averages.
+The load average numbers give the number of jobs in the run queue
+averaged over 1, 5 and 15 minutes.
+.PP
+The fields output are:
+the users login name,
+the name of the tty the user is on,
+the time of day the user logged on,
+the number of minutes since the user last typed anything,
+the CPU time used by all processes and their children on that terminal,
+the CPU time used by the currently active processes,
+the name and arguments of the current process.
+.PP
+The
+.B \-h
+flag suppresses the heading.
+The
+.B \-s
+flag asks for a short form of output.
+In the short form, the tty is abbreviated, the login time and cpu times
+are left off, as are the arguments to commands.
+.B \-l
+gives the long output, which is the default.
+.PP
+If a
+.I user
+name is included,
+the output will be restricted to that user.
+.SH FILES
+.ta 1i
+/etc/utmp
+.br
+/dev/kmem
+.br
+/dev/drum
+.SH "SEE ALSO"
+who(1), finger(1), ps(1)
+.SH AUTHOR
+Mark Horton
+.SH BUGS
+The notion of the ``current process'' is muddy.
+The current algorithm is ``the highest numbered process on
+the terminal that is not ignoring interrupts,
+or, if there is none, the highest numbered process on the terminal''.
+This fails, for example, in critical sections of programs
+like the shell and editor,
+or when faulty programs running in the background
+fork and fail to ignore interrupts.
+(In cases where no process can be found,
+.I w
+prints ``\-''.)
+.PP
+The CPU time is only an estimate, in particular, if someone leaves a
+background process running after logging out, the person currently
+on that terminal is ``charged'' with the time.
+.PP
+Background processes are not shown, even though they account for
+much of the load on the system.
+.PP
+Sometimes processes, typically those in the background, are
+printed with null or garbaged arguments.
+In these cases, the name of the command is printed in parentheses.
+.PP
+W does not know about the new conventions for detection of background jobs.
+It will sometimes find a background job instead of the right one.