version 1.10, 2000/03/06 03:15:59 |
version 1.11, 2000/03/10 20:17:49 |
|
|
.\" $OpenBSD$ |
.\" $OpenBSD$ |
|
.\" |
.\" Copyright (c) 1991 Keith Muller. |
.\" Copyright (c) 1991 Keith Muller. |
.\" Copyright (c) 1993 |
.\" Copyright (c) 1993 |
.\" The Regents of the University of California. All rights reserved. |
.\" The Regents of the University of California. All rights reserved. |
|
|
When multiple input files are specified, each is read, formatted, |
When multiple input files are specified, each is read, formatted, |
and written to standard output. |
and written to standard output. |
By default, the input is separated into 66-line pages, each with |
By default, the input is separated into 66-line pages, each with |
.sp |
.Bl -bullet -offset indent |
.in +2 |
.It |
.ti -2 |
A 5-line header with the page number, date, time, and |
\(bu A 5-line header with the page number, date, time, and |
|
the pathname of the file. |
the pathname of the file. |
.sp |
.It |
.ti -2 |
A 5-line trailer consisting of blank lines. |
\(bu A 5-line trailer consisting of blank lines. |
.El |
.in -2 |
|
.Pp |
.Pp |
Optionally, the trailer can be replaced by a |
Optionally, the trailer can be replaced by a |
.Em <form-feed> |
.Em <form-feed> |
|
|
.Fl column |
.Fl column |
option. |
option. |
.It Fl d |
.It Fl d |
Produce output that is double spaced. An extra |
Produce output that is double spaced. |
|
An extra |
.Em <newline> |
.Em <newline> |
character is output following every |
character is output following every |
.Em <newline> |
.Em <newline> |
|
|
If |
If |
.Ar char |
.Ar char |
(any nondigit character) is given, it is appended to the line number to |
(any nondigit character) is given, it is appended to the line number to |
separate it from whatever follows. The default for |
separate it from whatever follows. |
|
The default for |
.Ar char |
.Ar char |
is a |
is a |
.Em <tab> . |
.Em <tab> . |
|
|
operands are specified, or if a |
operands are specified, or if a |
.Ar file |
.Ar file |
operand is |
operand is |
.Sq Fl , |
.Dq - , |
the standard input is used. |
the standard input is used. |
The standard input is used only if no |
The standard input is used only if no |
.Ar file |
.Ar file |
operands are specified, or if a |
operands are specified, or if a |
.Ar file |
.Ar file |
operand is |
operand is |
.Sq Fl . |
.Dq - . |
.El |
.El |
.Pp |
.Pp |
The |
The |
|
|
.Em <form-feed>s |
.Em <form-feed>s |
in the input stream is that they are special |
in the input stream is that they are special |
.Em <newline>s |
.Em <newline>s |
which have the side effect of causing a page break. While this works |
which have the side effect of causing a page break. |
|
While this works |
correctly for all cases, strict interpretation also implies that the |
correctly for all cases, strict interpretation also implies that the |
common convention of placing a |
common convention of placing a |
.Em <form-feed> |
.Em <form-feed> |
|
|
errors when input lines are longer than actual line width of the output device. |
errors when input lines are longer than actual line width of the output device. |
.Pp |
.Pp |
The default width of 72 is archaic and non-obvious since it is normally |
The default width of 72 is archaic and non-obvious since it is normally |
ignored in the default single column mode. Using the |
ignored in the default single column mode. |
|
Using the |
.Fl m |
.Fl m |
option with one column provides a way to truncate single column output but |
option with one column provides a way to truncate single column output but |
there's no way to wrap long times to a fixed line width. |
there's no way to wrap long times to a fixed line width. |