.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
.TH PR "1" "December 2006" "pr 6.7" "User Commands"
.SH NAME
pr \- convert text files for printing
.SH SYNOPSIS
.B pr
[\fIOPTION\fR]... [\fIFILE\fR]...
.SH DESCRIPTION
.\" Add any additional description here
.PP
Paginate or columnate FILE(s) for printing.
.PP
Mandatory arguments to long options are mandatory for short options too.
.TP
+FIRST_PAGE[:LAST_PAGE], \fB\-\-pages\fR=\fIFIRST_PAGE[\fR:LAST_PAGE]
begin [stop] printing with page FIRST_[LAST_]PAGE
.TP
\fB\-COLUMN\fR, \fB\-\-columns\fR=\fICOLUMN\fR
output COLUMN columns and print columns down,
unless \fB\-a\fR is used. Balance number of lines in the
columns on each page.
.TP
\fB\-a\fR, \fB\-\-across\fR
print columns across rather than down, used together
with \fB\-COLUMN\fR
.TP
\fB\-c\fR, \fB\-\-show\-control\-chars\fR
use hat notation (^G) and octal backslash notation
.TP
\fB\-d\fR, \fB\-\-double\-space\fR
double space the output
.TP
\fB\-D\fR, \fB\-\-date\-format\fR=\fIFORMAT\fR
use FORMAT for the header date
.TP
\fB\-e[CHAR[WIDTH]]\fR, \fB\-\-expand\-tabs\fR[=\fICHAR[WIDTH]\fR]
expand input CHARs (TABs) to tab WIDTH (8)
.TP
\fB\-F\fR, \fB\-f\fR, \fB\-\-form\-feed\fR
use form feeds instead of newlines to separate pages
(by a 3\-line page header with \fB\-F\fR or a 5\-line header
and trailer without \fB\-F\fR)
.TP
\fB\-h\fR HEADER, \fB\-\-header\fR=\fIHEADER\fR
use a centered HEADER instead of filename in page header,
\fB\-h\fR "" prints a blank line, don't use \fB\-h\fR""
.TP
\fB\-i[CHAR[WIDTH]]\fR, \fB\-\-output\-tabs\fR[=\fICHAR[WIDTH]\fR]
replace spaces with CHARs (TABs) to tab WIDTH (8)
.TP
\fB\-J\fR, \fB\-\-join\-lines\fR
merge full lines, turns off \fB\-W\fR line truncation, no column
alignment, \fB\-\-sep\-string\fR[=\fISTRING\fR] sets separators
.TP
\fB\-l\fR PAGE_LENGTH, \fB\-\-length\fR=\fIPAGE_LENGTH\fR
set the page length to PAGE_LENGTH (66) lines
(default number of lines of text 56, and with \fB\-F\fR 63)
.TP
\fB\-m\fR, \fB\-\-merge\fR
print all files in parallel, one in each column,
truncate lines, but join lines of full length with \fB\-J\fR
.TP
\fB\-n[SEP[DIGITS]]\fR, \fB\-\-number\-lines\fR[=\fISEP[DIGITS]\fR]
number lines, use DIGITS (5) digits, then SEP (TAB),
default counting starts with 1st line of input file
.TP
\fB\-N\fR NUMBER, \fB\-\-first\-line\-number\fR=\fINUMBER\fR
start counting with NUMBER at 1st line of first
page printed (see +FIRST_PAGE)
.TP
\fB\-o\fR MARGIN, \fB\-\-indent\fR=\fIMARGIN\fR
offset each line with MARGIN (zero) spaces, do not
affect \fB\-w\fR or \fB\-W\fR, MARGIN will be added to PAGE_WIDTH
.TP
\fB\-r\fR, \fB\-\-no\-file\-warnings\fR
omit warning when a file cannot be opened
.TP
\fB\-s[CHAR]\fR,\-\-separator[=CHAR]
separate columns by a single character, default for CHAR
is the <TAB> character without \fB\-w\fR and 'no char' with \fB\-w\fR
\fB\-s[CHAR]\fR turns off line truncation of all 3 column
options (\fB\-COLUMN\fR|\-a \fB\-COLUMN\fR|\-m) except \fB\-w\fR is set
.TP
\fB\-SSTRING\fR, \fB\-\-sep\-string\fR[=\fISTRING\fR]
separate columns by STRING,
without \fB\-S\fR: Default separator <TAB> with \fB\-J\fR and <space>
otherwise (same as \fB\-S\fR" "), no effect on column options
.TP
\fB\-t\fR, \fB\-\-omit\-header\fR
omit page headers and trailers
.TP
\fB\-T\fR, \fB\-\-omit\-pagination\fR
omit page headers and trailers, eliminate any pagination
by form feeds set in input files
.TP
\fB\-v\fR, \fB\-\-show\-nonprinting\fR
use octal backslash notation
.TP
\fB\-w\fR PAGE_WIDTH, \fB\-\-width\fR=\fIPAGE_WIDTH\fR
set page width to PAGE_WIDTH (72) characters for
multiple text\-column output only, \fB\-s[char]\fR turns off (72)
.TP
\fB\-W\fR PAGE_WIDTH, \fB\-\-page\-width\fR=\fIPAGE_WIDTH\fR
set page width to PAGE_WIDTH (72) characters always,
truncate lines, except \fB\-J\fR option is set, no interference
with \fB\-S\fR or \fB\-s\fR
.TP
\fB\-\-help\fR
display this help and exit
.TP
\fB\-\-version\fR
output version information and exit
.PP
\fB\-T\fR implied by \fB\-l\fR nn when nn <= 10 or <= 3 with \fB\-F\fR. With no FILE, or when
FILE is \-, read standard input.
.SH AUTHOR
Written by Pete TerMaat and Roland Huebner.
.SH "REPORTING BUGS"
Report bugs to <bug\-coreutils@gnu.org>.
.SH COPYRIGHT
Copyright \(co 2006 Free Software Foundation, Inc.
.br
This is free software.  You may redistribute copies of it under the terms of
the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
The full documentation for
.B pr
is maintained as a Texinfo manual.  If the
.B info
and
.B pr
programs are properly installed at your site, the command
.IP
.B info pr
.PP
should give you access to the complete manual.