4.3BSD-Reno/share/man/cat1/cat.0

CAT(1)			    UNIX Reference Manual			CAT(1)

NNAAMMEE
     ccaatt - concatenate and print files

SSYYNNOOPPSSIISS
     ccaatt [--bbeennssttuuvv] [--] [_f_i_l_e ...]

DDEESSCCRRIIPPTTIIOONN
     The ccaatt utility reads files sequentially, writing them to the standard
     output.  The _f_i_l_e operands are processed in command line order.  A single
     dash represents standard input.

     The options are as follows:

     --bb    Implies the --nn option but doesn't number blank lines.

     --ee    Implies the --vv option, and displays a dollar sign (``$'') at the
	   end of each line as well.

     --nn    Number the _o_u_t_p_u_t lines, starting at 1.

     --ss    Squeeze multiple adjacent empty lines, causing the output to be
	   single spaced.

     --tt    Implies the --vv option, and displays tab characters as ``^I'' as
	   well.

     --uu    The --uu option guarantees that the output is unbuffered.

     --vv    Displays non-printing characters so they are visible.  Control
	   characters print line ``^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 charac-
	   ter for the low 7 bits.

     CCaatt is useful for getting files into a pipe, for instance, to sort two
     files together, the command

	   cat file1 file2 | sort > sfile

     reads the contents of file1 and file2 sequentially, pipes it all to sort
     and places the newly sorted data in file3.

     Because of the shell language mechanism used to perform output redirec-
     tion, the command ``cat file1 file 2 > file1'' will cause

     CCaatt The cat utility exits 0 on success, and >0 if an error occurs.

SSEEEE AALLSSOO
     head(1), more(1), pr(1), tail(1)

     Rob Pike, _U_N_I_X _S_t_y_l_e, _o_r _c_a_t -_v _C_o_n_s_i_d_e_r_e_d _H_a_r_m_f_u_l USENIX Summer Confer-
     ence Proceedings, 1983.

HHIISSTTOORRYY
     The ccaatt command appeared in Version 7 AT&T UNIX.