1
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.35.
2
.TH PR "1" "October 2012" "GNU coreutils 8.20" "User Commands"
4
pr \- convert text files for printing
7
[\fIOPTION\fR]... [\fIFILE\fR]...
9
.\" Add any additional description here
11
Paginate or columnate FILE(s) for printing.
13
Mandatory arguments to long options are mandatory for short options too.
15
+FIRST_PAGE[:LAST_PAGE], \fB\-\-pages\fR=\fIFIRST_PAGE[\fR:LAST_PAGE]
16
begin [stop] printing with page FIRST_[LAST_]PAGE
18
\fB\-COLUMN\fR, \fB\-\-columns\fR=\fICOLUMN\fR
19
output COLUMN columns and print columns down,
20
unless \fB\-a\fR is used. Balance number of lines in the
23
\fB\-a\fR, \fB\-\-across\fR
24
print columns across rather than down, used together
27
\fB\-c\fR, \fB\-\-show\-control\-chars\fR
28
use hat notation (^G) and octal backslash notation
30
\fB\-d\fR, \fB\-\-double\-space\fR
31
double space the output
33
\fB\-D\fR, \fB\-\-date\-format\fR=\fIFORMAT\fR
34
use FORMAT for the header date
36
\fB\-e[CHAR[WIDTH]]\fR, \fB\-\-expand\-tabs\fR[=\fICHAR[WIDTH]\fR]
37
expand input CHARs (TABs) to tab WIDTH (8)
39
\fB\-F\fR, \fB\-f\fR, \fB\-\-form\-feed\fR
40
use form feeds instead of newlines to separate pages
41
(by a 3\-line page header with \fB\-F\fR or a 5\-line header
42
and trailer without \fB\-F\fR)
44
\fB\-h\fR, \fB\-\-header\fR=\fIHEADER\fR
45
use a centered HEADER instead of filename in page header,
46
\fB\-h\fR "" prints a blank line, don't use \fB\-h\fR""
48
\fB\-i[CHAR[WIDTH]]\fR, \fB\-\-output\-tabs\fR[=\fICHAR[WIDTH]\fR]
49
replace spaces with CHARs (TABs) to tab WIDTH (8)
51
\fB\-J\fR, \fB\-\-join\-lines\fR
52
merge full lines, turns off \fB\-W\fR line truncation, no column
53
alignment, \fB\-\-sep\-string\fR[=\fISTRING\fR] sets separators
55
\fB\-l\fR, \fB\-\-length\fR=\fIPAGE_LENGTH\fR
56
set the page length to PAGE_LENGTH (66) lines
57
(default number of lines of text 56, and with \fB\-F\fR 63)
59
\fB\-m\fR, \fB\-\-merge\fR
60
print all files in parallel, one in each column,
61
truncate lines, but join lines of full length with \fB\-J\fR
63
\fB\-n[SEP[DIGITS]]\fR, \fB\-\-number\-lines\fR[=\fISEP[DIGITS]\fR]
64
number lines, use DIGITS (5) digits, then SEP (TAB),
65
default counting starts with 1st line of input file
67
\fB\-N\fR, \fB\-\-first\-line\-number\fR=\fINUMBER\fR
68
start counting with NUMBER at 1st line of first
69
page printed (see +FIRST_PAGE)
71
\fB\-o\fR, \fB\-\-indent\fR=\fIMARGIN\fR
72
offset each line with MARGIN (zero) spaces, do not
73
affect \fB\-w\fR or \fB\-W\fR, MARGIN will be added to PAGE_WIDTH
75
\fB\-r\fR, \fB\-\-no\-file\-warnings\fR
76
omit warning when a file cannot be opened
78
\fB\-s[CHAR]\fR, \fB\-\-separator\fR[=\fICHAR\fR]
79
separate columns by a single character, default for CHAR
80
is the <TAB> character without \fB\-w\fR and 'no char' with \fB\-w\fR
81
\fB\-s[CHAR]\fR turns off line truncation of all 3 column
82
options (\fB\-COLUMN\fR|\-a \fB\-COLUMN\fR|\-m) except \fB\-w\fR is set
84
\fB\-S[STRING]\fR, \fB\-\-sep\-string\fR[=\fISTRING\fR]
85
separate columns by STRING,
86
without \fB\-S\fR: Default separator <TAB> with \fB\-J\fR and <space>
87
otherwise (same as \fB\-S\fR" "), no effect on column options
89
\fB\-t\fR, \fB\-\-omit\-header\fR
90
omit page headers and trailers
92
\fB\-T\fR, \fB\-\-omit\-pagination\fR
93
omit page headers and trailers, eliminate any pagination
94
by form feeds set in input files
96
\fB\-v\fR, \fB\-\-show\-nonprinting\fR
97
use octal backslash notation
99
\fB\-w\fR, \fB\-\-width\fR=\fIPAGE_WIDTH\fR
100
set page width to PAGE_WIDTH (72) characters for
101
multiple text\-column output only, \fB\-s[char]\fR turns off (72)
103
\fB\-W\fR, \fB\-\-page\-width\fR=\fIPAGE_WIDTH\fR
104
set page width to PAGE_WIDTH (72) characters always,
105
truncate lines, except \fB\-J\fR option is set, no interference
106
with \fB\-S\fR or \fB\-s\fR
109
display this help and exit
112
output version information and exit
114
\fB\-t\fR is implied if PAGE_LENGTH <= 10. With no FILE, or when FILE is \-, read
117
Written by Pete TerMaat and Roland Huebner.
119
Report pr bugs to bug\-coreutils@gnu.org
121
GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
123
General help using GNU software: <http://www.gnu.org/gethelp/>
125
Report pr translation bugs to <http://translationproject.org/team/>
127
Copyright \(co 2012 Free Software Foundation, Inc.
128
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
130
This is free software: you are free to change and redistribute it.
131
There is NO WARRANTY, to the extent permitted by law.
133
The full documentation for
135
is maintained as a Texinfo manual. If the
139
programs are properly installed at your site, the command
141
.B info coreutils \(aqpr invocation\(aq
143
should give you access to the complete manual.
added
removed
man/pr.1
