pr(1)pr(1)NAMEpr - print files
SYNOPSIS
[options] [files]
DESCRIPTION
The command prints the named files on the standard output. If file is
or if no files are specified, the standard input is assumed. By
default, the listing is separated into pages, each headed by the page
number, a date and time, and the name of the file.
By default, columns are of equal width, separated by at least one
space; lines that do not fit are truncated. If the option is used,
lines are not truncated and columns are separated by the separation
character.
If the standard output is associated with a terminal, error messages
are withheld until has completed printing.
Options
The following options can be used singly or combined in any order:
Begin printing with page
k (default is 1).
Produce k-column output (default is 1). This option should
not be used with The options and are assumed for
multi-column output.
Produce k-column output, same as
Print multi-column output across the page.
This option is appropriate only with the option.
Merge and print all files simultaneously,
one per column (overrides the and options).
Double space the output.
Expand input tabs to character positions k+1, 2×k+1, 3×k+1,
etc. If k is 0 or is omitted, default tab settings at
every eighth position are assumed. Tab characters in
the input are expanded into the appropriate number of
spaces. If c (any nondigit character) is given, it is
treated as the input tab character (default for c is
the tab character).
In output, replace white space wherever possible by
inserting tabs to character positions k+1, 2×k+1,
3×k+1, etc. If k is 0 or is omitted, default tab set‐
tings at every eighth position are assumed. If c (any
nondigit character) is given, it is treated as the
output tab character (default for c is the tab charac‐
ter).
Provide k-digit line numbering (default for k is 5). The num‐
ber occupies the first k+1 character positions of each
column of normal output or each line of output. If c
(any nondigit character) is given, it is appended to
the line number to separate it from whatever follows
(default for c is a tab).
Set the width of a line to
k character positions (default is 72 for equal-width,
multi-column output; no limit otherwise). Width spec‐
ifications are only effective for multi-columnar out‐
put.
Offset each line by
k character positions (default is 0). The number of
character positions per line is the sum of the width
and offset.
Set the length of a page to
k lines (default is 66). If k is less than what is
needed for the page header and trailer, the option is
in effect; that is, header and trailer lines are sup‐
pressed in order to make room for text.
Use the next argument as the header to be printed
instead of the file name.
Pause before beginning each page
if the output is directed to a terminal rings the bell
at the terminal and waits for a Return).
Use form-feed character for new pages
(default is to use a sequence of line-feeds). Pause
before beginning the first page if the standard output
is associated with a terminal.
Same as Provided for backwards compatibility.
Print no diagnostic reports on failure to open files.
Print neither the five-line identifying header
nor the five-line trailer normally supplied for each
page. Quit printing after the last line of each file
without spacing to the end of the page.
Separate columns by the single character
c instead of by the appropriate number of spaces
(default for c is a tab).
EXTERNAL INFLUENCES
Environment Variables
determines the interpretation of text and the arguments associated with
the and options as single-byte and/or multi-byte characters.
determines the format and contents of date and time strings.
determines the language in which messages are displayed.
If or is not specified in the environment or is set to the empty
string, the value of is used as a default for each unspecified or empty
variable. If is not specified or is set to the empty string, a default
of (see lang(5)) is used instead of
If any internationalization variable contains an invalid setting,
behaves as if all internationalization variables are set to See envi‐
ron(5).
International Code Set Support
Single-byte and multi-byte character code sets are supported.
RETURN VALUE
The returns the following values upon completion:
Successful completion.
One or more of the input
files do not exist or cannot be opened.
EXAMPLES
Print and as a double spaced, three column listing headed by ``file
list'':
Write on expanding tabs to columns 10, 19, 28, 37, ... :
Print in default format with nonblank lines numbered down the left
side:
FILES
SEE ALSO
cat(1), lp(1), nl(1), ul(1).
STANDARDS CONFORMANCEpr(1)