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

PR(1)			    UNIX Reference Manual			 PR(1)

NNAAMMEE
     pprr - Print files.

SSYYNNOOPPSSIISS
     pprr [++_p_a_g_e] [--_c_o_l_u_m_n] [--ff] [--hhhheeaaddeerr] [--lllliinneess] [--mm] [--ss_c_h_a_r] [--tt]
	[--ww_w_i_d_t_h] [_f_i_l_e ...]

DDEESSCCRRIIPPTTIIOONN
     The pprr utility is a printing and pagination filter.  If multiple input
     files are specified, each is read, formatted, and written to standard
     output.  By default, the input is separated into pages, each with a
     header that includes the page number, date, time, and the file's path-
     name.  Text columns are of equal width, with at least one <blank> separa-
     tion between text columns.  Lines that do not fit into a text column are
     truncated.  If standard output is associated with a terminal, diagnostic
     messages are suppressed until the pprr utility has completed processing.

     The following options are available:

     ++_p_a_g_e     Begin output at page number page of the formatted input.

     --_c_o_l_u_m_n   Produce output that is columns wide (default is 1) and is in
	       text column rank order.	This option should not be used with
	       --mm.  When used with --tt, use the minimum number of lines to
	       display the output.

     --ff        Use <form-feed> character for new pages, instead of the default
	       behavior that uses a sequence of <newline> characters.  Prior
	       to displaying the first page of output an <alert> character is
	       written to standard output.

     --hh_h_e_a_d_e_r
	       Use the string header as the header to be printed instead of
	       file.

     --ll_l_i_n_e_s   Override the 66 line default and reset the page length to
	       lines.  If lines is smaller than the sum of both the header and
	       trailer depths (in lines), the pr utility suppresses both the
	       header and trailer, as if the --tt option were in effect.

     --mm        Merge files.  Standard output is formatted so the pprr utility
	       writes one line from each file specified by a file operand,
	       side by side into text columns of equal fixed widths, in terms
	       of the number of column positions.

     --ss_c_h_a_r    Separate text columns by the single character char instead of
	       by the appropriate number of <space>s (default for char is the
	       <tab> character).

     --tt        Print neither the five-line identifying header nor the five-
	       line trailer usually supplied for each page.  Quit printing
	       after the last line of each file without spacing to the end of
	       the page.

     --ww_w_i_d_t_h   Set the width of the line to width column positions for
	       multiple text-column output only (default is 72).

     The following operands are available:

     _f_i_l_e      A pathname of a file to be printed.

     If no file operands are specified, or if a file operand is `--', the
     standard input is used.

     The standard input is used only if no file operands are specified, or if
     a file operand is `--'.

     If pr receives an interrupt while printing to a terminal, it flushes all
     accumulated error messages to the screen before terminating.

     The pr utility output is a paginated version of the original file (or
     files).  This pagination is optionally done using <form-feed>s or a
     sequence of <newline>s.  Page headers are generated unless the --tt option
     is specified.

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

     Error messages are written to standard error during the printing process
     (if output is redirected) or after all successful file printing is com-
     plete (when printing to a terminal).

SSEEEE AALLSSOO
     more(1)

SSTTAANNDDAARRDDSS
     The pprr function is expected to be POSIX 1003.2 compatible.