.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.30)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{
.    if \nF \{
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "PR 1"
.TH PR 1 "2001-06-06" "perl v5.20.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
pr \-\- convert text files for printing
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\f(CW\*(C`pr [\-columns] [+page} [\-adFfrts] [\-n[char][count]] [\-schar] [\-ei] [\-w width]\*(C'\fR
	\f(CW\*(C`[\-o count] [\-l length] [\-h text] files\*(C'\fR
.PP
\&\f(CW\*(C`pr \-m [+page} [\-adFfrts] [\-n[char][count]] [\-schar] [\-ei] [\-w width]\*(C'\fR
	\f(CW\*(C`[\-o count] [\-l length] [\-h text] files\*(C'\fR
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fIpr\fR formats text into fixed-length pages with headers, multiple columns and 
other options suitable for hardcopy output.
.SS "\s-1OPTIONS\s0"
.IX Subsection "OPTIONS"
\&\fIpr\fR accepts the following option:
.IP "\-columns" 4
.IX Item "-columns"
Causes \fIpr\fR to print text in columns down the page.  Note that \fIpr\fR does not attempt
to fold lines which are too long to fit in their column and long lines and control characters
will affect output.  Column width decreases as the number of columns goes up.  \fI\-w\fR 
should be used to make the page wider.
.IP "+page" 4
.IX Item "+page"
Begin numbering pages at page number \fIpage\fR.
.IP "\-a" 4
.IX Item "-a"
Multiple columns are filled from left-to-right down the page.
.IP "\-m" 4
.IX Item "-m"
Each input file is given a column in the output, and printing continues until
all input files are exhausted.
.IP "\-d" 4
.IX Item "-d"
Output is double-spaced
.IP "\-f" 4
.IX Item "-f"
Formfeed characters are used instead of trailing blank lines to control 
page length.  \fI\-F\fR is a synonym for \fI\-f\fR.
.IP "\-r" 4
.IX Item "-r"
Do not print a message if files cannot be opened
.IP "\-t" 4
.IX Item "-t"
Suppress the 5\-line header and 5\-line trailer on each page
.IP "\-s\fBchar\fR" 4
.IX Item "-schar"
The single character \fBchar\fR will be used to separate multi-column output.  
Note that the columns are no-longer fixed-width with this option.
.IP "\-n[\fBchar\fR[\fBcount\fR]]" 4
.IX Item "-n[char[count]]"
Precede each column with a line number.  \fBcount\fR is the desired width of 
the line numbering (numbers too large are truncated).  \fBchar\fR can be used to 
separate numbers from the output line, tab is used if \fBchar\fR is not specified.
.IP "\-e" 4
.IX Item "-e"
Not implemented in this version, accepted for comptability.
.IP "\-i" 4
.IX Item "-i"
Not implemented in this version, accepted for comptability.
.IP "\-w \fBwidth\fR" 4
.IX Item "-w width"
Width of the page, in characters.  Note that excessively long lines are not folded or
truncated\*(--they simply keep printing.  This may foul column alignment.  Defaults to 72.
.IP "\-l \fBlength\fR" 4
.IX Item "-l length"
Length of the page, in lines.  Defaults to 66.
.IP "\-o \fBcount\fR" 4
.IX Item "-o count"
Offset each line with a left margin \fBcount\fR characters wide.  This is in addition to 
the width specified with the \fI\-w\fR option.
.IP "\-h \fBtext\fR" 4
.IX Item "-h text"
Use \fBtext\fR in the header for each file, instead of the file name
.SH "BUGS"
.IX Header "BUGS"
The \fI\-e\fR and \fI\-i\fR switches are not implemented in this version.
.PP
Input which contains carriage returns, or other \s-1ASCII\s0 control characters will
affect the alignment of columns, and may affect page-length counts.  This includes
overprinting and backspaces.
.PP
Excessively long lines will cause \fIpr\fR to mis-align columns in multi-column
output.
.SH "AUTHOR"
.IX Header "AUTHOR"
The Perl implementation of \fIpr\fR was written by Clinton Pierce, \fIclintp@geeksalad.org\fR.
.SH "COPYRIGHT and LICENSE"
.IX Header "COPYRIGHT and LICENSE"
This program is Copyright 1999, by Clinton Pierce.
.PP
Freely redistributable under the Perl Artistic License.