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
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

AUTHOR

117       Written by Pete TerMaat and Roland Huebner.
118

REPORTING BUGS

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

SEE ALSO

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.5                November 2010                           PR(1)
Impressum