PR(1) | General Commands Manual | PR(1) |
pr
— print
files
pr |
[+page]
[- column]
[-adFfmprt ] [[-e ]
[char] [gap]]
[-L locale]
[-h header]
[[-i ] [char]
[gap]]
[-l lines]
[-o offset]
[[-s ] [char]]
[[-n ] [char]
[width]]
[-w width] [-]
[file ...] |
The pr
utility is a printing and
pagination filter for text files. When multiple input files are specified,
each is read, formatted, and written to standard output. By default, the
input is separated into 66-line pages, each with
If standard output is associated with a terminal, diagnostic
messages are suppressed until the pr
utility has
completed processing.
When multiple column output is specified, text columns are of equal width. By default text columns are separated by at least one <blank>. Input lines that do not fit into a text column are truncated. Lines are not truncated under single column output.
In the following option descriptions, column, lines, offset, page, and width are positive decimal integers and gap is a nonnegative decimal integer.
-
column-e
and -i
are assumed. This option should not be used
with -m
. When used with
-t
, the minimum number of lines is used to display
the output. (To columnify and reshape text files more generally and
without additional formatting, see the
rs(1) utility.)-a
-column
option so that
the columns are filled across the page in a round-robin order (e.g., when
column is 2, the first input line heads column 1, the second heads column
2, the third is the second line in column 1, etc.). This option requires
the use of the -column
option.-d
-e
[char][gap]-F
-f
-F
but pause before beginning the first
page if standard output is a terminal.-h
header-i
[char][gap]-L
locale-l
linespr
utility suppresses output of both the header
and trailer, as if the -t
option were in
effect.-m
-e
and
-i
are assumed.-n
[char][width]-m
output. If
char (any nondigit character) is given, it is
appended to the line number to separate it from whatever follows. The
default for char is a <tab>.
Line numbers longer than width columns are
truncated.-o
offset-o
option is not specified, the default is
zero. The space taken is in addition to the output line width.-p
pr
will write an alert character to standard error
and wait for a carriage return to be read on the terminal.-r
-s
char-t
-w
width-w
option is not specified and the -s
option is not
specified, the default width is 72. If the -w
option is not specified and the -s
option is
specified, the default width is 512.-
’, the standard input is used. The
standard input is used only if no file operands are
specified, or if a file operand is
‘-
’.The -s
option does not allow the option
letter to be separated from its argument, and the options
-e
, -i
, and
-n
require that both arguments, if present, not be
separated from the option letter.
The pr
utility exits 0 on success,
and >0 if an error occurs.
If pr
receives an interrupt while printing
to a terminal, it flushes all accumulated error messages to the screen
before terminating.
Error 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).
The last space before the tab stop is replaced with a tab character. In legacy mode, it is not.
For more information about legacy mode, see compat(5).
The pr
utility is IEEE
Std 1003.1-2001 (“POSIX.1”) compatible.
A pr
command appeared in
Version 1 AT&T UNIX.
The pr
utility does not recognize
multibyte characters.
July 3, 2004 | macOS 14.6 |