1 cfa37a7b 2004-04-10 devnull .TH CAT 1
  2 cfa37a7b 2004-04-10 devnull .SH NAME
  3 058b0118 2005-01-03 devnull cat, read, nobs \- catenate files
  4 cfa37a7b 2004-04-10 devnull .SH SYNOPSIS
  5 cfa37a7b 2004-04-10 devnull .B cat
  6 cfa37a7b 2004-04-10 devnull [
  7 cfa37a7b 2004-04-10 devnull .I file ...
  8 cfa37a7b 2004-04-10 devnull ]
  9 cfa37a7b 2004-04-10 devnull .br
 10 cfa37a7b 2004-04-10 devnull .B read
 11 cfa37a7b 2004-04-10 devnull [
 12 cfa37a7b 2004-04-10 devnull .B -m
 13 cfa37a7b 2004-04-10 devnull ] [
 14 cfa37a7b 2004-04-10 devnull .B -n
 15 cfa37a7b 2004-04-10 devnull .I nline
 16 cfa37a7b 2004-04-10 devnull ] [
 17 cfa37a7b 2004-04-10 devnull .I file ...
 18 cfa37a7b 2004-04-10 devnull ]
 19 058b0118 2005-01-03 devnull .br
 20 c8b6342d 2005-01-13 devnull .B nobs
 21 058b0118 2005-01-03 devnull [
 22 058b0118 2005-01-03 devnull .I file ...
 23 058b0118 2005-01-03 devnull ]
 24 cfa37a7b 2004-04-10 devnull .SH DESCRIPTION
 25 cfa37a7b 2004-04-10 devnull .I Cat
 26 cfa37a7b 2004-04-10 devnull reads each
 27 cfa37a7b 2004-04-10 devnull .I file
 28 cfa37a7b 2004-04-10 devnull in sequence and writes it on the standard output.
 29 cfa37a7b 2004-04-10 devnull Thus
 30 cfa37a7b 2004-04-10 devnull .IP
 31 cfa37a7b 2004-04-10 devnull .L
 32 cfa37a7b 2004-04-10 devnull cat file
 33 cfa37a7b 2004-04-10 devnull .LP
 34 cfa37a7b 2004-04-10 devnull prints a file and
 35 cfa37a7b 2004-04-10 devnull .IP
 36 cfa37a7b 2004-04-10 devnull .L
 37 cfa37a7b 2004-04-10 devnull cat file1 file2 >file3
 38 cfa37a7b 2004-04-10 devnull .LP
 39 cfa37a7b 2004-04-10 devnull concatenates the first two files and places the result
 40 cfa37a7b 2004-04-10 devnull on the third.
 41 cfa37a7b 2004-04-10 devnull .PP
 42 cfa37a7b 2004-04-10 devnull If no
 43 cfa37a7b 2004-04-10 devnull .I file
 44 cfa37a7b 2004-04-10 devnull is given,
 45 cfa37a7b 2004-04-10 devnull .I cat 
 46 cfa37a7b 2004-04-10 devnull reads from the standard input.
 47 cfa37a7b 2004-04-10 devnull Output is buffered in blocks matching the input.
 48 cfa37a7b 2004-04-10 devnull .PP
 49 cfa37a7b 2004-04-10 devnull .I Read
 50 cfa37a7b 2004-04-10 devnull copies to standard output exactly one line from the named
 51 cfa37a7b 2004-04-10 devnull .IR file ,
 52 cfa37a7b 2004-04-10 devnull default standard input.
 53 cfa37a7b 2004-04-10 devnull It is useful in interactive
 54 d32deab1 2020-08-16 rsc .MR rc (1)
 55 cfa37a7b 2004-04-10 devnull scripts.
 56 cfa37a7b 2004-04-10 devnull .PP
 57 cfa37a7b 2004-04-10 devnull The
 58 cfa37a7b 2004-04-10 devnull .B -m
 59 cfa37a7b 2004-04-10 devnull flag causes it to continue reading and writing multiple lines until end of file;
 60 cfa37a7b 2004-04-10 devnull .B -n
 61 cfa37a7b 2004-04-10 devnull causes it to read no more than
 62 cfa37a7b 2004-04-10 devnull .I nline
 63 cfa37a7b 2004-04-10 devnull lines.
 64 cfa37a7b 2004-04-10 devnull .PP
 65 058b0118 2005-01-03 devnull .I Read
 66 058b0118 2005-01-03 devnull always executes a single
 67 cfa37a7b 2004-04-10 devnull .B write
 68 cfa37a7b 2004-04-10 devnull for each line of input, which can be helpful when
 69 cfa37a7b 2004-04-10 devnull preparing input to programs that expect line-at-a-time data.
 70 cfa37a7b 2004-04-10 devnull It never reads any more data from the input than it prints to the output.
 71 058b0118 2005-01-03 devnull .PP
 72 058b0118 2005-01-03 devnull .I Nobs
 73 058b0118 2005-01-03 devnull copies the named files to
 74 058b0118 2005-01-03 devnull standard output except that it removes all backspace
 75 058b0118 2005-01-03 devnull characters and the characters that precede them.
 76 058b0118 2005-01-03 devnull It is useful to use as
 77 058b0118 2005-01-03 devnull .B $PAGER
 78 058b0118 2005-01-03 devnull with the Unix version of
 79 d32deab1 2020-08-16 rsc .MR man (1)
 80 058b0118 2005-01-03 devnull when run inside a
 81 058b0118 2005-01-03 devnull .I win
 82 058b0118 2005-01-03 devnull (see
 83 d32deab1 2020-08-16 rsc .MR acme (1) )
 84 058b0118 2005-01-03 devnull window.
 85 cfa37a7b 2004-04-10 devnull .SH SOURCE
 86 c3674de4 2005-01-11 devnull .B \*9/src/cmd/cat.c
 87 cfa37a7b 2004-04-10 devnull .br
 88 c3674de4 2005-01-11 devnull .B \*9/src/cmd/read.c
 89 058b0118 2005-01-03 devnull .br
 90 c3674de4 2005-01-11 devnull .B \*9/bin/nobs
 91 cfa37a7b 2004-04-10 devnull .SH SEE ALSO
 92 d32deab1 2020-08-16 rsc .MR cp (1)
 93 cfa37a7b 2004-04-10 devnull .SH DIAGNOSTICS
 94 cfa37a7b 2004-04-10 devnull .I Read
 95 cfa37a7b 2004-04-10 devnull exits with status
 96 cfa37a7b 2004-04-10 devnull .B eof
 97 cfa37a7b 2004-04-10 devnull on end of file or, in the
 98 cfa37a7b 2004-04-10 devnull .B -n
 99 cfa37a7b 2004-04-10 devnull case, if it doesn't read
100 cfa37a7b 2004-04-10 devnull .I nlines
101 cfa37a7b 2004-04-10 devnull lines.
102 cfa37a7b 2004-04-10 devnull .SH BUGS
103 cfa37a7b 2004-04-10 devnull Beware of
104 cfa37a7b 2004-04-10 devnull .L "cat a b >a"
105 cfa37a7b 2004-04-10 devnull and
106 cfa37a7b 2004-04-10 devnull .LR "cat a b >b" ,
107 cfa37a7b 2004-04-10 devnull which
108 cfa37a7b 2004-04-10 devnull destroy input files before reading them.