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