Scroll to navigation

PR(1) User Commands PR(1)

NAME

pr - convert text files for printing

SYNOPSIS

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

DESCRIPTION

Paginate or columnate FILE(s) for printing.

With no FILE, or when FILE is -, read standard input.

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

+FIRST_PAGE[:LAST_PAGE], --pages=FIRST_PAGE[:LAST_PAGE]
begin [stop] printing with page FIRST_[LAST_]PAGE
output COLUMN columns and print columns down, unless -a is used. Balance number of lines in the columns on each page
print columns across rather than down, used together with -COLUMN
use hat notation (^G) and octal backslash notation
double space the output
use FORMAT for the header date
expand input CHARs (TABs) to tab WIDTH (8)
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)
use a centered HEADER instead of filename in page header, -h "" prints a blank line, don't use -h""
replace spaces with CHARs (TABs) to tab WIDTH (8)
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). implies -t if PAGE_LENGTH <= 10
print all files in parallel, one in each column, truncate lines, but join lines of full length with -J
number lines, use DIGITS (5) digits, then SEP (TAB), default counting starts with 1st line of input file
start counting with NUMBER at 1st line of first page printed (see +FIRST_PAGE)
offset each line with MARGIN (zero) spaces, do not affect -w or -W, MARGIN will be added to PAGE_WIDTH
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
separate columns by STRING, without -S: Default separator <TAB> with -J and <space> otherwise (same as -S" "), no effect on column options
omit page headers and trailers; implied if PAGE_LENGTH <= 10
omit page headers and trailers, eliminate any pagination by form feeds set in input files
use octal backslash notation
set page width to PAGE_WIDTH (72) characters for multiple text-column output only, -s[char] turns off (72)
set page width to PAGE_WIDTH (72) characters always, truncate lines, except -J option is set, no interference with -S or -s
display this help and exit
output version information and exit

AUTHOR

Written by Pete TerMaat and Roland Huebner.

REPORTING BUGS

GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
Report any translation bugs to <https://translationproject.org/team/>

COPYRIGHT

Copyright © 2023 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

SEE ALSO

Full documentation <https://www.gnu.org/software/coreutils/pr>
or available locally via: info '(coreutils) pr invocation'

March 2024 GNU coreutils 9.4