.\" Copyright (c) 1990 The Regents of the University of California.
.\" %sccs.include.redist.man%
.\" @(#)pr.1 6.2 (Berkeley) %G%
utility is a printing and pagination filter.
input files are specified, each is read, formatted,
and written to standard output.
separated into pages, each with a header that includes the
page number, date, time, and the file's pathname.
columns are of equal width, with at least one <blank>
separation 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 pr utility has completed processing.
The following options are available:
Begin output at page number page of the
Produce output that is columns wide (default
is 1) and is in text column rank order.
option should not be used with \-m.
used with \-t, use the minimum number of lines
Use <form-feed> character for new pages,
instead of the default behavior that uses a
sequence of <newline> characters.
displaying the first page of output an
<alert> character is written to standard output.
Use the string header as the header to be
Override the 66 line default and reset the
than the sum of both the header and trailer
depths (in lines), the pr utility suppresses
both the header and trailer, as if the \-t
Standard output is formatted so
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.
Separate text columns by the single character
char instead of by the appropriate number of
<space>s (default for char is the <tab> character).
Print neither the five-line identifying
header nor the five-line trailer usually
last line of each file without spacing to the
Set the width of the line to width column
positions for multiple text-column output
The following operands are available:
A pathname of a file to be printed.
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
The pr utility output is a paginated version of the original
This pagination is optionally done using
<form-feed>s or a sequence of <newline>s.
generated unless the \-t option is specified.
utility exits 0 on success, and >0 if an error occurs.
messages are written to standard error during the printing
process (if output is redirected) or after all successful
file printing is complete (when printing to a terminal).
function is expected to be POSIX 1003.2 compatible.