1PR(1) User Commands PR(1)
2
3
4
6 pr - convert text files for printing
7
9 pr [OPTION]... [FILE]...
10
12 Paginate or columnate FILE(s) for printing.
13
14 Mandatory arguments to long options are mandatory for short options
15 too.
16
17 +FIRST_PAGE[:LAST_PAGE], --pages=FIRST_PAGE[:LAST_PAGE]
18 begin [stop] printing with page FIRST_[LAST_]PAGE
19
20 -COLUMN, --columns=COLUMN
21 output COLUMN columns and print columns down, unless -a is used.
22 Balance number of lines in the columns on each page.
23
24 -a, --across
25 print columns across rather than down, used together with -COL‐
26 UMN
27
28 -c, --show-control-chars
29 use hat notation (^G) and octal backslash notation
30
31 -d, --double-space
32 double space the output
33
34 -D, --date-format=FORMAT
35 use FORMAT for the header date
36
37 -e[CHAR[WIDTH]], --expand-tabs[=CHAR[WIDTH]]
38 expand input CHARs (TABs) to tab WIDTH (8)
39
40 -F, -f, --form-feed
41 use form feeds instead of newlines to separate pages (by a
42 3-line page header with -F or a 5-line header and trailer with‐
43 out -F)
44
45 -h, --header=HEADER
46 use a centered HEADER instead of filename in page header, -h ""
47 prints a blank line, don't use -h""
48
49 -i[CHAR[WIDTH]], --output-tabs[=CHAR[WIDTH]]
50 replace spaces with CHARs (TABs) to tab WIDTH (8)
51
52 -J, --join-lines
53 merge full lines, turns off -W line truncation, no column align‐
54 ment, --sep-string[=STRING] sets separators
55
56 -l, --length=PAGE_LENGTH
57 set the page length to PAGE_LENGTH (66) lines (default number of
58 lines of text 56, and with -F 63)
59
60 -m, --merge
61 print all files in parallel, one in each column, truncate lines,
62 but join lines of full length with -J
63
64 -n[SEP[DIGITS]], --number-lines[=SEP[DIGITS]]
65 number lines, use DIGITS (5) digits, then SEP (TAB), default
66 counting starts with 1st line of input file
67
68 -N, --first-line-number=NUMBER
69 start counting with NUMBER at 1st line of first page printed
70 (see +FIRST_PAGE)
71
72 -o, --indent=MARGIN
73 offset each line with MARGIN (zero) spaces, do not affect -w or
74 -W, MARGIN will be added to PAGE_WIDTH
75
76 -r, --no-file-warnings
77 omit warning when a file cannot be opened
78
79 -s[CHAR], --separator[=CHAR]
80 separate columns by a single character, default for CHAR is the
81 <TAB> character without -w and 'no char' with -w -s[CHAR] turns
82 off line truncation of all 3 column options (-COLUMN|-a -COL‐
83 UMN|-m) except -w is set
84
85 -SSTRING, --sep-string[=STRING]
86 separate columns by STRING, without -S: Default separator <TAB>
87 with -J and <space> otherwise (same as -S" "), no effect on col‐
88 umn options
89
90 -t, --omit-header
91 omit page headers and trailers
92
93 -T, --omit-pagination
94 omit page headers and trailers, eliminate any pagination by form
95 feeds set in input files
96
97 -v, --show-nonprinting
98 use octal backslash notation
99
100 -w, --width=PAGE_WIDTH
101 set page width to PAGE_WIDTH (72) characters for multiple
102 text-column output only, -s[char] turns off (72)
103
104 -W, --page-width=PAGE_WIDTH
105 set page width to PAGE_WIDTH (72) characters always, truncate
106 lines, except -J option is set, no interference with -S or -s
107
108 --help display this help and exit
109
110 --version
111 output version information and exit
112
113 -t is implied if PAGE_LENGTH <= 10. With no FILE, or when FILE is -,
114 read standard input.
115
117 Written by Pete TerMaat and Roland Huebner.
118
120 Report pr bugs to bug-coreutils@gnu.org
121 GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
122 General help using GNU software: <http://www.gnu.org/gethelp/>
123 Report pr translation bugs to <http://translationproject.org/team/>
124
126 Copyright © 2010 Free Software Foundation, Inc. License GPLv3+: GNU
127 GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
128 This is free software: you are free to change and redistribute it.
129 There is NO WARRANTY, to the extent permitted by law.
130
132 The full documentation for pr is maintained as a Texinfo manual. If
133 the info and pr programs are properly installed at your site, the com‐
134 mand
135
136 info coreutils 'pr invocation'
137
138 should give you access to the complete manual.
139
140
141
142GNU coreutils 8.4 June 2018 PR(1)