BSD 3 development
[unix-history] / usr / man / man1 / pr.1
CommitLineData
10d1b371
BJ
1.TH PR 1
2.SH NAME
3pr \- print file
4.SH SYNOPSIS
5.B pr
6[ option ] ...
7[ file ] ...
8.SH DESCRIPTION
9.I Pr
10produces a printed listing of one or more
11.I files.
12The output is separated into pages headed by a date,
13the name of the file or a specified header, and the page number.
14If there are no file arguments,
15.I pr
16prints its standard input.
17.PP
18Options apply to all following files but may be reset
19between files:
20.TP
21.BI \- n
22Produce
23.IR n -column
24output.
25.TP
26.BI + n
27Begin printing with page
28.I n.
29.TP
30.B \-h
31Take the next argument as a page header.
32.TP
33.BI \-w n
34For purposes of multi-column output,
35take the width of the page to be
36.I n
37characters instead of the default 72.
38.TP
39.BI \-l n
40Take the length of the page to be
41.I n
42lines instead of the default 66.
43.TP
44.B \-t
45Do not print the 5-line header or the
465-line trailer normally supplied for each page.
47.TP
48.BI \-s c
49Separate columns by the single character
50.I c
51instead of by the appropriate amount of white space.
52A missing
53.I c
54is taken to be a tab.
55.TP
56.B \-m
57Print all
58.I files
59simultaneously,
60each in one column,
61.PP
62Inter-terminal messages via
63.IR write (1)
64are
65forbidden during a
66.IR pr .
67.SH FILES
68/dev/tty?
69to suspend messages.
70.SH "SEE ALSO"
71cat(1)
72.SH DIAGNOSTICS
73There are no diagnostics when
74.I pr
75is printing on a terminal.