document distributed with 4.2BSD

[unix-history] / usr / src / bin / cat / cat.1

diff --git a/usr/src/bin/cat/cat.1 b/usr/src/bin/cat/cat.1
index 110457a..20a14d2 100644 (file)
--- a/usr/src/bin/cat/cat.1
+++ b/usr/src/bin/cat/cat.1
@@ -2,9 +2,9 @@
 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"
 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"

-.\"    @(#)cat.1       4.1 (Berkeley) %G%
+.\"    @(#)cat.1       6.2 (Berkeley) %G%

 .\"
 .\"

-.TH CAT 1 
+.TH CAT 1 ""

 .UC 4
 .SH NAME
 cat \- catenate and print
 .UC 4
 .SH NAME
 cat \- catenate and print


@@ -25,62 +25,57 @@ file ...
 .I Cat
 reads each
 .I file
 .I Cat
 reads each
 .I file

-in sequence
-and writes it on the standard output.
-Thus
+in sequence and displays it on the standard output.  Thus

 .PP
 .ti+15n
 cat file
 .PP
 .PP
 .ti+15n
 cat file
 .PP

-prints the file, and
+displays the file on the standard output, and

 .PP
 .ti+15n
 cat file1 file2 >file3
 .PP
 concatenates the first two files and places the result on the third.
 .PP
 .PP
 .ti+15n
 cat file1 file2 >file3
 .PP
 concatenates the first two files and places the result on the third.
 .PP

-If no input file is given,
-or if the argument `\-' is encountered,
+If no input file is given, or if the argument `\-' is encountered,

 .I cat
 .I cat

-reads from the standard
-input file.
-Output is buffered in 1024-byte blocks unless the standard
-output is a terminal, in which case it is line buffered.
-The
+reads from the standard input file.
+Output is buffered in the block size recommended by \fIstat\fP(2)
+unless the standard output is a terminal,
+when it is line buffered.  The

 .B \-u
 .B \-u

-option causes the output to be completely unbuffered.
+option makes the output completely unbuffered.

 .PP
 .PP

-The option
+The

 .B \-n
 .B \-n

-causes the output lines to be numbered sequentially from 1.
-Giving
+option displays the output lines preceded by lines numbers, numbered
+sequentially from 1.  Specifying the 

 .B \-b
 .B \-b

-with
+option with the

 .B \-n
 .B \-n

-causes numbers to be omitted from blank lines.
+option omits the line numbers from blank lines.

 .PP
 .PP

-The option
+The

 .B \-s
 .B \-s

-causes the output to be single spaced by crushing out multiple adjacent
-empty lines.
+option crushes out multiple adjacent empty lines so that the
+output is displayed single spaced.

 .PP
 .PP

-The option
+The

 .B \-v
 .B \-v

-causes non-printing characters to be printed in a visible way.
+option displays non-printing characters so that they are visible.

 Control characters print like ^X for control-x; the delete character
 (octal 0177) prints as ^?.
 Non-ascii characters (with the high bit set) are printed as M-
 Control characters print like ^X for control-x; the delete character
 (octal 0177) prints as ^?.
 Non-ascii characters (with the high bit set) are printed as M-

-(for meta) followed by the character of the low 7 bits.
-A
+(for meta) followed by the character of the low 7 bits.  A

 .B \-e
 .B \-e

-option may be given with
+option may be given with the

 .B \-v
 .B \-v

-and causes the ends of lines to be followed by the character `$';
-the
+option, which displays a `$' character at the end of each line.
+Specifying the 

 .B \-t
 .B \-t

-option with
+option with the

 .B \-v
 .B \-v

-causes tabs to be printed as ^I.
+option displays tab characters as ^I.

 .PP
 .SH "SEE ALSO"
 cp(1), ex(1), more(1), pr(1), tail(1)
 .PP
 .SH "SEE ALSO"
 cp(1), ex(1), more(1), pr(1), tail(1)