Return to cat CVS log

Up to [Plan 9 NeXT] / lucent / sys / man / 1

Annotation of lucent/sys/man/1/cat, revision 1.1.1.1

1.1       root        1: .TH CAT 1
                      2: .SH NAME
                      3: cat, read \- catenate files
                      4: .SH SYNOPSIS
                      5: .B cat
                      6: [
                      7: .I file ...
                      8: ]
                      9: .br
                     10: .B read
                     11: [
                     12: .I file
                     13: ]
                     14: .SH DESCRIPTION
                     15: .I Cat
                     16: reads each
                     17: .I file
                     18: in sequence and writes it on the standard output.
                     19: Thus
                     20: .IP
                     21: .L
                     22: cat file
                     23: .LP
                     24: prints a file and
                     25: .IP
                     26: .L
                     27: cat file1 file2 >file3
                     28: .LP
                     29: concatenates the first two files and places the result
                     30: on the third.
                     31: .PP
                     32: If no
                     33: .I file
                     34: is given,
                     35: .I cat 
                     36: reads from the standard input.
                     37: Output is buffered in blocks matching the input.
                     38: .PP
                     39: .I Read
                     40: copies one line from the named file
                     41: to standard output.
                     42: It is useful in interactive
                     43: .IR rc (1)
                     44: scripts.
                     45: .SH SOURCE
                     46: .B /sys/src/cmd/cat.c
                     47: .br
                     48: .B /sys/src/cmd/read.c
                     49: .SH SEE ALSO
                     50: .IR cp (1)
                     51: .SH DIAGNOSTICS
                     52: .I Read
                     53: exits with status
                     54: .B eof
                     55: on end of file.
                     56: .SH BUGS
                     57: Beware of
                     58: .L "cat a b >a"
                     59: and
                     60: .LR "cat a b >b" ,
                     61: which
                     62: destroy input files before reading them.

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