.TH PR 1L \" -*- nroff -*-
pr \- convert text files for printing
[+PAGE] [\-COLUMN] [\-abcdfFmrtv] [\-e[in-tab-char[in-tab-width]]]
[\-h header] [\-i[out-tab-char[out-tab-width]]] [\-l page-length]
[\-n[number-separator[digits]]] [\-o left-margin]
[\-s[column-separator]] [\-w page-width] [\-\-help] [\-\-version] [file...]
documents the GNU version of
prints on the standard output a paginated and optionally multicolumn
copy of the text files given on the command line, or of the standard
input if no files are given or when the file name `\-' is encountered.
Form feeds in the input cause page breaks in the output.
Begin printing with page \fIPAGE\fP.
Produce \fICOLUMN\fP-column output and print columns down. The column
width is automatically decreased as \fICOLUMN\fP increases; unless you
use the \fI\-w\fP option to increase the page width as well, this
option might cause some columns to be truncated.
Print columns across rather than down.
Balance columns on the last page.
Print control characters using hat notation (e.g., `^G'); print other
unprintable characters in octal backslash notation.
.I "\-e[in-tab-char[in-tab-width]]"
Expand tabs to spaces on input. Optional argument \fIin-tab-char\fP
is the input tab character, default tab. Optional argument
\fIin-tab-width\fP is the input tab character's width, default 8.
Use a formfeed instead of newlines to separate output pages.
Replace the filename in the header with the string \fIheader\fP.
Print a usage message and exit with a non-zero status.
.I "\-i[out-tab-char[out-tab-width]]"
Replace spaces with tabs on output. Optional argument
\fIout-tab-char\fP is the output tab character, default tab.
Optional argument \fIout-tab-width\fP is the output tab character's
Set the page length to \fIpage-length\fP lines. The default is 66.
If \fIpage-length\fP is less than 10, the headers and footers are
omitted, as if the \fI\-t\fP option had been given.
Print all files in parallel, one in each column.
.I "\-n[number-separator[digits]]"
Precede each column with a line number; with parallel files, precede
each line with a line number. Optional argument
\fInumber-separator\fP is the character to print after each number,
default tab. Optional argument \fIdigits\fP is the number of digits
per line number, default 5.
Offset each line with a margin \fIleft-margin\fP spaces wide. The
total page width is this offset plus the width set with the \fI\-w\fP
Do not print a warning message when an argument file cannot be opened.
Failure to open a file still makes the exit status nonzero, however.
.I "\-s[column-separator]"
Separate columns by the single character \fIcolumn-separator\fP,
default tab, instead of spaces.
Do not print the 5-line header and the 5-line trailer that are
normally on each page, and do not fill out the bottoms of pages (with
blank lines or formfeeds).
Print unprintable characters in octal backslash notation.
Print version information on standard error then exit.
Set the page width to \fIpage-width\fP columns. The default is 72.