[unix-history] / usr / src / man / man1 / pr.1

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