Return to cat.1 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man1

Annotation of cci/usr/src/man/man1/cat.1, revision 1.1.1.2

1.1       root        1: .TH CAT 1 "18 January 1983"
                      2: .UC 4
                      3: .SH NAME
1.1.1.2 ! root        4: cat \- concatenate and print
1.1       root        5: .SH SYNOPSIS
                      6: .B cat
                      7: [
                      8: .B \-u
                      9: ] [
                     10: .B \-n
                     11: ] [
                     12: .B \-s
                     13: ] [
                     14: .B \-v
                     15: ]
                     16: file ...
                     17: .br
                     18: .SH DESCRIPTION
                     19: .I Cat
                     20: reads each
                     21: .I file
                     22: in sequence and displays it on the standard output.  Thus
                     23: .PP
                     24: .ti+15n
                     25: cat file
                     26: .PP
                     27: displays the file on the standard output, and
                     28: .PP
                     29: .ti+15n
                     30: cat file1 file2 >file3
                     31: .PP
                     32: concatenates the first two files and places the result on the third.
                     33: .PP
1.1.1.2 ! root       34: If the
        !            35: .I file
        !            36: is omitted or supplied as '\-', then the standard input is used. A file name of '\-' may also be used in a series of file names, as in:
        !            37: .PP
        !            38: .ti+15n
        !            39:  cat -n filename1 - filename2. 
        !            40: .PP
1.1       root       41: Output is buffered in 1024-byte blocks unless the standard
                     42: output is a terminal, in which case it is line buffered.  The
                     43: .B \-u
                     44: option makes the output completely unbuffered.
                     45: .PP
                     46: The
                     47: .B \-n
                     48: option displays the output lines preceded by lines numbers, numbered
                     49: sequentially from 1.  Specifying the 
                     50: .B \-b
                     51: option with the
                     52: .B \-n
                     53: option omits the line numbers from blank lines.
                     54: .PP
                     55: The
                     56: .B \-s
1.1.1.2 ! root       57: option deletes adjacent empty lines so that the
1.1       root       58: output is displayed single spaced.
                     59: .PP
                     60: The
                     61: .B \-v
                     62: option displays non-printing characters so that they are visible.
                     63: Control characters print like ^X for control-x; the delete character
                     64: (octal 0177) prints as ^?.
                     65: Non-ascii characters (with the high bit set) are printed as M-
                     66: (for meta) followed by the character of the low 7 bits.  A
                     67: .B \-e
                     68: option may be given with the
                     69: .B \-v
                     70: option, which displays a `$' character at the end of each line.
                     71: Specifying the 
                     72: .B \-t
                     73: option with the
                     74: .B \-v
                     75: option displays tab characters as ^I.
                     76: .PP
                     77: .SH "SEE ALSO"
                     78: cp(1), ex(1), more(1), pr(1), tail(1)
                     79: .SH BUGS
                     80: Beware of `cat a b >a' and `cat a b >b', which destroy
                     81: the input files before reading them.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.