Debian Codegraph @

upstream/debian-unstable/man1/pr.1

raw
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.50.1.
2 .TH PR "1" "February 2026" "GNU coreutils 9.10" "User Commands"
3 .SH NAME
4 pr \- convert text files for printing
5 .SH SYNOPSIS
6 .B pr
7 [\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]...
8 .SH DESCRIPTION
9 .\" Add any additional description here
10 .PP
11 Paginate or columnate FILE(s) for printing.
12 .PP
13 With no FILE, or when FILE is \-, read standard input.
14 .PP
15 Mandatory arguments to long options are mandatory for short options too.
16 .TP
17 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr--pages'\fB+FIRST_PAGE[:LAST_PAGE], \-\-pages=\,FIRST_PAGE[:LAST_PAGE]\fP\X'tty: link'\/\fR
18 begin [stop] printing with page FIRST_[LAST_]PAGE
19 .TP
20 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-COLS'\fB\-COLS, \-\-columns=\,COLS\fP\X'tty: link'\/\fR
21 output COLS columns and print columns down, unless \fB\-a\fR is used.
22 Balance number of lines in the columns on each page
23 .TP
24 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-a'\fB\-a, \-\-across\fP\X'tty: link'
25 print columns across rather than down, used together with \fB\-COLUMN\fR
26 .TP
27 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-c'\fB\-c, \-\-show\-control\-chars\fP\X'tty: link'
28 use hat notation (^G) and octal backslash notation
29 .TP
30 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-d'\fB\-d, \-\-double\-space\fP\X'tty: link'
31 double space the output
32 .TP
33 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-D'\fB\-D, \-\-date\-format=\,FORMAT\fP\X'tty: link'\/\fR
34 use FORMAT for the header date
35 .TP
36 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-e'\fB\-e[CHAR[WIDTH]], \-\-expand\-tabs[=\,CHAR[WIDTH]]\fP\X'tty: link'\/\fR
37 expand input CHARs (TABs) to tab WIDTH (8)
38 .TP
39 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-F'\fB\-F, \-f, \-\-form\-feed\fP\X'tty: link'
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)
43 .TP
44 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-h'\fB\-h, \-\-header=\,HEADER\fP\X'tty: link'\/\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""
47 .TP
48 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-i'\fB\-i[CHAR[WIDTH]], \-\-output\-tabs[=\,CHAR[WIDTH]]\fP\X'tty: link'\/\fR
49 replace spaces with CHARs (TABs) to tab WIDTH (8)
50 .TP
51 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-J'\fB\-J, \-\-join\-lines\fP\X'tty: link'
52 merge full lines, turns off \fB\-W\fR line truncation,
53 no column alignment, \fB\-\-sep\-string\fR[=\fI\,STRING\/\fR] sets separators
54 .TP
55 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-l'\fB\-l, \-\-length=\,PAGE_LENGTH\fP\X'tty: link'\/\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).
58 implies \fB\-t\fR if PAGE_LENGTH <= 10
59 .TP
60 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-m'\fB\-m, \-\-merge\fP\X'tty: link'
61 print all files in parallel, one in each column,
62 truncate lines, but join lines of full length with \fB\-J\fR
63 .TP
64 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-n'\fB\-n[SEP[DIGITS]], \-\-number\-lines[=\,SEP[DIGITS]]\fP\X'tty: link'\/\fR
65 number lines, use DIGITS (5) digits, then SEP (TAB),
66 default counting starts with 1st line of input file
67 .TP
68 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-N'\fB\-N, \-\-first\-line\-number=\,NUMBER\fP\X'tty: link'\/\fR
69 start counting with NUMBER at 1st line of first
70 page printed (see +FIRST_PAGE)
71 .TP
72 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-o'\fB\-o, \-\-indent=\,MARGIN\fP\X'tty: link'\/\fR
73 offset each line with MARGIN (zero) spaces, do not
74 affect \fB\-w\fR or \fB\-W\fR, MARGIN will be added to PAGE_WIDTH
75 .TP
76 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-r'\fB\-r, \-\-no\-file\-warnings\fP\X'tty: link'
77 omit warning when a file cannot be opened
78 .TP
79 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-s'\fB\-s[CHAR], \-\-separator[=\,CHAR]\fP\X'tty: link'\/\fR
80 separate columns by a single character, default for CHAR
81 is the <TAB> character without \fB\-w\fR and 'no char' with \fB\-w\fR.
82 \fB\-s\fR[\fI\,CHAR\/\fR] turns off line truncation of all 3 column
83 options (\fB\-COLUMN\fR|\-a \fB\-COLUMN\fR|\-m) except \fB\-w\fR is set
84 .TP
85 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-S'\fB\-S[STRING], \-\-sep\-string[=\,STRING]\fP\X'tty: link'\/\fR
86 separate columns by STRING,
87 without \fB\-S\fR: Default separator <TAB> with \fB\-J\fR and <space>
88 otherwise (same as \fB\-S\fR" "), no effect on column options
89 .TP
90 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-t'\fB\-t, \-\-omit\-header\fP\X'tty: link'
91 omit page headers and trailers; implied if PAGE_LENGTH <= 10
92 .TP
93 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-T'\fB\-T, \-\-omit\-pagination\fP\X'tty: link'
94 omit page headers and trailers,
95 eliminate any pagination by form feeds set in input files
96 .TP
97 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-v'\fB\-v, \-\-show\-nonprinting\fP\X'tty: link'
98 use octal backslash notation
99 .TP
100 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-w'\fB\-w, \-\-width=\,PAGE_WIDTH\fP\X'tty: link'\/\fR
101 set page width to PAGE_WIDTH (72) characters for
102 multiple text\-column output only, \fB\-s\fR[\fI\,char\/\fR] turns off (72)
103 .TP
104 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#pr-W'\fB\-W, \-\-page\-width=\,PAGE_WIDTH\fP\X'tty: link'\/\fR
105 set page width to PAGE_WIDTH (72) characters always,
106 truncate lines, except \fB\-J\fR option is set,
107 no interference with \fB\-S\fR or \fB\-s\fR
108 .TP
109 \X'tty: link https://www.gnu.org/software/coreutils/pr#pr--help'\fB\-\-help\fP\X'tty: link'
110 display this help and exit
111 .TP
112 \X'tty: link https://www.gnu.org/software/coreutils/pr#pr--version'\fB\-\-version\fP\X'tty: link'
113 output version information and exit
114 .SH AUTHOR
115 Written by Pete TerMaat and Roland Huebner.
116 .SH "REPORTING BUGS"
117 Report bugs to: bug\[email protected]
118 .br
119 GNU coreutils home page: <https://www.gnu.org/software/coreutils/>
120 .br
121 General help using GNU software: <https://www.gnu.org/gethelp/>
122 .br
123 Report any translation bugs to <https://translationproject.org/team/>
124 .SH "SEE ALSO"
125 Full documentation <https://www.gnu.org/software/coreutils/pr>
126 .br
127 or available locally via: info \(aq(coreutils) pr invocation\(aq
128 .PP
129 .br
130 Packaged by Debian (9.10\-1)
131 .br
132 Copyright \(co 2026 Free Software Foundation, Inc.
133 .br
134 License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
135 .br
136 This is free software: you are free to change and redistribute it.
137 .br
138 There is NO WARRANTY, to the extent permitted by law.