pr
(1g)
Name
pr - convert text files for printing
Synopsis
pr [OPTION]... [FILE]...
Description
User Commands PR(1)
NAME
pr - convert text files for printing
SYNOPSIS
pr [OPTION]... [FILE]...
DESCRIPTION
Paginate or columnate FILE(s) for printing.
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
-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
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 col-
umn alignment, --sep-string[=STRING] sets separators
GNU coreutils 8.16 Last change: March 2012 1
User Commands PR(1)
-l, --length=PAGE_LENGTH
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, trun-
cate 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, --first-line-number=NUMBER
start counting with NUMBER at 1st line of first page
printed (see +FIRST_PAGE)
-o, --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
-s[CHAR], --separator[=CHAR]
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
-S[STRING], --sep-string[=STRING]
separate columns by STRING, without -S: Default separa-
tor <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 pagina-
tion by form feeds set in input files
-v, --show-nonprinting
use octal backslash notation
-w, --width=PAGE_WIDTH
set page width to PAGE_WIDTH (72) characters for multi-
ple text-column output only, -s[char] turns off (72)
-W, --page-width=PAGE_WIDTH
set page width to PAGE_WIDTH (72) characters always,
truncate lines, except -J option is set, no interfer-
ence with -S or -s
GNU coreutils 8.16 Last change: March 2012 2
User Commands PR(1)
--help
display this help and exit
--version
output version information and exit
-t is implied if PAGE_LENGTH <= 10. With no FILE, or when
FILE is -, read standard input.
AUTHOR
Written by Pete TerMaat and Roland Huebner.
REPORTING BUGS
Report pr bugs to [email protected]
GNU coreutils home page: <http://www.gnu.org/software/core-
utils/>
General help using GNU software: <http://www.gnu.org/geth-
elp/>
Report pr translation bugs to <http://translationpro-
ject.org/team/>
COPYRIGHT
Copyright (C) 2012 Free Software Foundation, Inc. License
GPLv3+: GNU GPL version 3 or later
<http://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redis-
tribute it. There is NO WARRANTY, to the extent permitted
by law.
ATTRIBUTES
See attributes(5) for descriptions of the following
attributes:
+---------------+--------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+--------------------+
|Availability | file/gnu-coreutils |
+---------------+--------------------+
|Stability | Uncommitted |
+---------------+--------------------+
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 coreutils 'pr invocation'
should give you access to the complete manual.
GNU coreutils 8.16 Last change: March 2012 3
User Commands PR(1)
NOTES
This software was built from source available at
https://java.net/projects/solaris-userland. The original
community source was downloaded from
http://ftp.gnu.org/gnu/coreutils/coreutils-8.16.tar.xz
Further information about this software can be found on the
open source community website at http://www.gnu.org/soft-
ware/coreutils/.
GNU coreutils 8.16 Last change: March 2012 4