diff options
-rw-r--r-- | bin/cat/cat.1 | 57 |
1 files changed, 29 insertions, 28 deletions
diff --git a/bin/cat/cat.1 b/bin/cat/cat.1 index ac282346928..1073420b5bf 100644 --- a/bin/cat/cat.1 +++ b/bin/cat/cat.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: cat.1,v 1.24 2003/06/02 23:32:06 millert Exp $ +.\" $OpenBSD: cat.1,v 1.25 2004/07/02 10:28:34 jmc Exp $ .\" $NetBSD: cat.1,v 1.12 1995/09/27 05:38:55 cgd Exp $ .\" .\" Copyright (c) 1989, 1990, 1993 @@ -60,58 +60,57 @@ reads from the standard input. .Pp The options are as follows: .Bl -tag -width Ds -.It Fl n -Number the output lines, starting at 1. .It Fl b Implies the .Fl n option but doesn't count blank lines. -.It Fl v -Displays non-printing characters so they are visible. -Control characters print as -.Ql ^X -for control-X. -The only exception is the tab character, control-I (see the -.Fl t -option). -The -.Tn DEL -character (octal 0177) prints as -.Ql ^? . -.Pf Non- Ns Tn ASCII -characters (with the high bit set) are printed as -.Ql M- -(for meta) followed by the character for the low 7 bits. .It Fl e Implies the .Fl v option and also prints a dollar sign .Pq Ql \&$ at the end of each line. +.It Fl n +Number the output lines, starting at 1. +.It Fl s +Squeeze multiple adjacent empty lines, causing the output to be +single spaced. .It Fl t Implies the .Fl v option and also prints tab characters as .Ql ^I . -.It Fl s -Squeeze multiple adjacent empty lines, causing the output to be -single spaced. .It Fl u The output is guaranteed to be unbuffered (see .Xr setbuf 3 ) . +.It Fl v +Displays non-printing characters so they are visible. +Control characters print as +.Ql ^X +for control-X, with the exception of the tab and EOL characters, +which are displayed normally. +The tab character, control-I, can be made visible via the +.Fl t +option. +The +.Tn DEL +character (octal 0177) prints as +.Ql ^? . +.Pf Non- Ns Tn ASCII +characters (with the high bit set) are printed as +.Ql M- +(for meta) followed by the character for the low 7 bits. .El .Pp The .Nm utility exits 0 on success or >0 if an error occurred. .Sh EXAMPLES -.Li $ cat file1 -.Pp Print the contents of .Ar file1 -to the standard output. +to the standard output: .Pp -.Li $ cat file1 file2 > file3 +.Dl $ cat file1 .Pp Sequentially print the contents of .Ar file1 @@ -122,11 +121,11 @@ to the file truncating .Ar file3 if it already exists. -See the manual page for your shell (i.e., +See the manual page for your shell (e.g., .Xr sh 1 ) for more information on redirection. .Pp -.Li $ cat file1 - file2 - file3 +.Dl $ cat file1 file2 > file3 .Pp Print the contents of .Ar file1 , @@ -145,6 +144,8 @@ would have already been read and printed by when it encountered the first .Ql \&- operand. +.Pp +.Dl $ cat file1 - file2 - file3 .Sh SEE ALSO .Xr head 1 , .Xr less 1 , |