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       With no FILE, or when FILE is -, read standard input.
15
16       Mandatory  arguments  to  long  options are mandatory for short options
17       too.
18
19       +FIRST_PAGE[:LAST_PAGE], --pages=FIRST_PAGE[:LAST_PAGE]
20              begin [stop] printing with page FIRST_[LAST_]PAGE
21
22       -COLUMN, --columns=COLUMN
23              output COLUMN columns and print columns down, unless -a is used.
24              Balance number of lines in the columns on each page
25
26       -a, --across
27              print  columns across rather than down, used together with -COL‐
28              UMN
29
30       -c, --show-control-chars
31              use hat notation (^G) and octal backslash notation
32
33       -d, --double-space
34              double space the output
35
36       -D, --date-format=FORMAT
37              use FORMAT for the header date
38
39       -e[CHAR[WIDTH]], --expand-tabs[=CHAR[WIDTH]]
40              expand input CHARs (TABs) to tab WIDTH (8)
41
42       -F, -f, --form-feed
43              use form feeds instead of  newlines  to  separate  pages  (by  a
44              3-line  page header with -F or a 5-line header and trailer with‐
45              out -F)
46
47       -h, --header=HEADER
48              use a centered HEADER instead of filename in page header, -h  ""
49              prints a blank line, don't use -h""
50
51       -i[CHAR[WIDTH]], --output-tabs[=CHAR[WIDTH]]
52              replace spaces with CHARs (TABs) to tab WIDTH (8)
53
54       -J, --join-lines
55              merge full lines, turns off -W line truncation, no column align‐
56              ment, --sep-string[=STRING] sets separators
57
58       -l, --length=PAGE_LENGTH
59              set the page length to PAGE_LENGTH (66) lines (default number of
60              lines of text 56, and with -F 63).  implies -t if PAGE_LENGTH <=
61              10
62
63       -m, --merge
64              print all files in parallel, one in each column, truncate lines,
65              but join lines of full length with -J
66
67       -n[SEP[DIGITS]], --number-lines[=SEP[DIGITS]]
68              number  lines,  use  DIGITS  (5) digits, then SEP (TAB), default
69              counting starts with 1st line of input file
70
71       -N, --first-line-number=NUMBER
72              start counting with NUMBER at 1st line  of  first  page  printed
73              (see +FIRST_PAGE)
74
75       -o, --indent=MARGIN
76              offset  each line with MARGIN (zero) spaces, do not affect -w or
77              -W, MARGIN will be added to PAGE_WIDTH
78
79       -r, --no-file-warnings
80              omit warning when a file cannot be opened
81
82       -s[CHAR], --separator[=CHAR]
83              separate columns by a single character, default for CHAR is  the
84              <TAB>  character  without  -w  and  'no char' with -w.  -s[CHAR]
85              turns off line truncation of all 3  column  options  (-COLUMN|-a
86              -COLUMN|-m) except -w is set
87
88       -S[STRING], --sep-string[=STRING]
89              separate  columns by STRING, without -S: Default separator <TAB>
90              with -J and <space> otherwise (same as -S" "), no effect on col‐
91              umn options
92
93       -t, --omit-header
94              omit page headers and trailers; implied if PAGE_LENGTH <= 10
95
96       -T, --omit-pagination
97              omit page headers and trailers, eliminate any pagination by form
98              feeds set in input files
99
100       -v, --show-nonprinting
101              use octal backslash notation
102
103       -w, --width=PAGE_WIDTH
104              set page  width  to  PAGE_WIDTH  (72)  characters  for  multiple
105              text-column output only, -s[char] turns off (72)
106
107       -W, --page-width=PAGE_WIDTH
108              set  page  width  to PAGE_WIDTH (72) characters always, truncate
109              lines, except -J option is set, no interference with -S or -s
110
111       --help display this help and exit
112
113       --version
114              output version information and exit
115

AUTHOR

117       Written by Pete TerMaat and Roland Huebner.
118

REPORTING BUGS

120       GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
121       Report any translation bugs to <https://translationproject.org/team/>
122
124       Copyright © 2022 Free Software Foundation, Inc.   License  GPLv3+:  GNU
125       GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
126       This  is  free  software:  you  are free to change and redistribute it.
127       There is NO WARRANTY, to the extent permitted by law.
128

SEE ALSO

130       Full documentation <https://www.gnu.org/software/coreutils/pr>
131       or available locally via: info '(coreutils) pr invocation'
132
133
134
135GNU coreutils 9.1                January 2023                            PR(1)
Impressum