Table of Contents


pr - convert text files for printing


pr [OPTION]... [FILE]...


Paginate or columnate FILE(s) for printing.

Mandatory arguments to long options are mandatory for short options too.

begin [stop] printing with page FIRST_[LAST_]PAGE

-COLUMN, --columns=COLUMN
output COLUMN columns and print columns down, unless -a is used. Balance number of lines in the columns on each page.

-a, --across
print columns across rather than down, used together with -COLUMN

-c, --show-control-chars
use hat notation (^G) and octal backslash notation

-d, --double-space
double space the output

-D, --date-format=FORMAT
use FORMAT for the header date

-e[CHAR[WIDTH]], --expand-tabs[=CHAR[WIDTH]]
expand input CHARs (TABs) to tab WIDTH (8)

-F, -f, --form-feed
use form feeds instead of newlines to separate pages (by a 3-line page header with -F or a 5-line header and trailer without -F)

-h HEADER, --header=HEADER
use a centered HEADER instead of filename in page header, -h “" prints a blank line, don’t use -h""

-i[CHAR[WIDTH]], --output-tabs[=CHAR[WIDTH]]
replace spaces with CHARs (TABs) to tab WIDTH (8)

-J, --join-lines
merge full lines, turns off -W line truncation, no column alignment, --sep-string[=STRING] sets separators

set the page length to PAGE_LENGTH (66) lines (default number of lines of text 56, and with -F 63)

-m, --merge
print all files in parallel, one in each column, truncate lines, but join lines of full length with -J

-n[SEP[DIGITS]], --number-lines[=SEP[DIGITS]]
number lines, use DIGITS (5) digits, then SEP (TAB), default counting starts with 1st line of input file

-N NUMBER, --first-line-number=NUMBER
start counting with NUMBER at 1st line of first page printed (see +FIRST_PAGE)

-o MARGIN, --indent=MARGIN
offset each line with MARGIN (zero) spaces, do not affect -w or -W, MARGIN will be added to PAGE_WIDTH

-r, --no-file-warnings
omit warning when a file cannot be opened

separate columns by a single character, default for CHAR is the <TAB> character without -w and ‘no char’ with -w -s[CHAR] turns off line truncation of all 3 column options (-COLUMN|-a -COLUMN|-m) except -w is set

-SSTRING, --sep-string[=STRING]
separate columns by STRING, without -S: Default separator <TAB> with -J and <space> otherwise (same as -S” “), no effect on column options

-t, --omit-header omit page headers and trailers

-T, --omit-pagination
omit page headers and trailers, eliminate any pagination by form feeds set in input files

-v, --show-nonprinting
use octal backslash notation

set page width to PAGE_WIDTH (72) characters for multiple text-column output only, -s[char] turns off (72)

-W PAGE_WIDTH, --page-width=PAGE_WIDTH
set page width to PAGE_WIDTH (72) characters always, truncate lines, except -J option is set, no interference with -S or -s

--help display this help and exit

output version information and exit

implied by -l nn when nn <= 10 or <= 3 with -F. With no FILE, or when FILE is -, read standard input.


Written by Pete TerMaat and Roland Huebner.

Reporting Bugs

Report bugs to <>.


Copyright (C) 2006 Free Software Foundation, Inc. This is free software. You may redistribute copies of it under the terms of the GNU General Public License <>. There is NO WARRANTY, to the extent permitted by law.

See Also

The full documentation for pr is maintained as a Texinfo manual. If the info and pr programs are properly installed at your site, the command

info pr

should give you access to the complete manual.

Table of Contents

Privacy Policy