1PR(1)                            User Commands                           PR(1)
2
3
4

NAME

6       pr - convert text files for printing
7

SYNOPSIS

9       pr [OPTION]... [FILE]...
10

DESCRIPTION

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=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 PAGE_LENGTH, --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 NUMBER, --first-line-number=NUMBER
69              start  counting  with  NUMBER  at 1st line of first page printed
70              (see +FIRST_PAGE)
71
72       -o MARGIN, --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 PAGE_WIDTH, --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=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  implied  by  -l  nn when nn <= 10 or <= 3 with -F. With no FILE, or
114       when FILE is -, read standard input.
115

AUTHOR

117       Written by Pete TerMaat and Roland Huebner.
118

REPORTING BUGS

120       Report bugs to <bug-coreutils@gnu.org>.
121

COPYRIGHT

123       Copyright © 2007 Free Software Foundation, Inc.
124       This is free software.  You may redistribute copies  of  it  under  the
125       terms       of       the      GNU      General      Public      License
126       <http://www.gnu.org/licenses/gpl.html>.  There is NO WARRANTY,  to  the
127       extent permitted by law.
128

SEE ALSO

130       The  full  documentation  for pr is maintained as a Texinfo manual.  If
131       the info and pr programs are properly installed at your site, the  com‐
132       mand
133
134              info pr
135
136       should give you access to the complete manual.
137
138
139
140GNU coreutils 6.9                 March 2008                             PR(1)