version 1.13, 2001/09/05 16:34:54 |
version 1.14, 2001/11/28 22:09:28 |
|
|
.\" |
.\" |
.\" @(#)fmt.1 8.1 (Berkeley) 6/6/93 |
.\" @(#)fmt.1 8.1 (Berkeley) 6/6/93 |
.\" |
.\" |
.\" Modified by Gareth McCaughan to describe the new version of `fmt' |
|
.\" rather than the old one. |
|
.Dd June 6, 1993 |
.Dd June 6, 1993 |
.Dt FMT 1 |
.Dt FMT 1 |
.Os |
.Os |
|
|
length defaults |
length defaults |
to 65 and the |
to 65 and the |
.Ar maximum |
.Ar maximum |
to 10 more than the goal length. |
to 10 more than the |
|
.Ar goal |
|
length. |
Alternatively, a single |
Alternatively, a single |
.Ar width |
.Ar width |
parameter can be specified either by prepending a hyphen to it or by using |
parameter can be specified either by prepending a hyphen to it or by using |
.Fl w . |
.Fl w . |
For example, |
For example, |
.Dl fmt -w 72 , |
.Dq Li fmt -w 72 , |
.Dl fmt -72 , |
.Dq Li fmt -72 , |
and |
and |
.Dl fmt 72 72 |
.Dq Li fmt 72 72 |
all produce identical output. |
all produce identical output. |
The spacing at the beginning of the input lines is preserved in the output, |
The spacing at the beginning of the input lines is preserved in the output, |
as are blank lines and interword spacing. |
as are blank lines and interword spacing. |
|
|
results in a new paragraph being begun. |
results in a new paragraph being begun. |
.It Fl s |
.It Fl s |
Collapse whitespace inside lines, so that multiple whitespace |
Collapse whitespace inside lines, so that multiple whitespace |
characters are turned into a single space. (Or, at the end of a |
characters are turned into a single space. |
|
(Or, at the end of a |
sentence, a double space.) |
sentence, a double space.) |
.It Fl d Ar chars |
.It Fl d Ar chars |
Treat the |
Treat the |
.Ar chars |
.Ar chars |
(and no others) as sentence-ending characters. |
(and no others) as sentence-ending characters. |
By default the |
By default the |
sentence-ending characters are full stop, question mark and |
sentence-ending characters are full stop |
exclamation mark. |
.Pq Ql \&. , |
|
question mark |
|
.Pq Ql \&? |
|
and exclamation mark |
|
.Pq Ql \&! . |
Remember that some characters may need to be |
Remember that some characters may need to be |
escaped to protect them from your shell. |
escaped to protect them from your shell. |
.It Fl l Ar number |
.It Fl l Ar number |
|
|
.Xr mail 1 , |
.Xr mail 1 , |
.Xr nroff 1 |
.Xr nroff 1 |
.Sh HISTORY |
.Sh HISTORY |
An |
The |
.Nm |
.Nm |
command appeared in |
command appeared in |
.Bx 3 . |
.Bx 3 . |
.Pp |
.Pp |
The version described herein is a complete rewrite and appeared in |
The version described herein is a complete rewrite and appeared in |
.Ox 2.4 . |
.Ox 2.4 . |
.\" .Sh AUTHOR |
.Sh AUTHORS |
.\" Kurt Shoens |
.An Kurt Shoens |
.\" .br |
.An Liz Allen |
.\" Liz Allen (added goal length concept) |
(added goal length concept) |
.\" The above are the authors of the old `fmt' program; |
.An Gareth McCaughan |
.\" the present one was written by Gareth McCaughan. |
(wrote this version) |
.Sh BUGS |
.Sh BUGS |
The program was designed to be simple and fast \- for more complex |
The program was designed to be simple and fast \- for more complex |
operations, the standard text processors are likely to be more appropriate. |
operations, the standard text processors are likely to be more appropriate. |