xref: /csrg-svn/usr.bin/fmt/fmt.1 (revision 61997)
1*61997Sbostic.\" Copyright (c) 1980, 1990, 1993
2*61997Sbostic.\"	The Regents of the University of California.  All rights reserved.
319138Smckusick.\"
443693Scael.\" %sccs.include.redist.man%
519138Smckusick.\"
6*61997Sbostic.\"     @(#)fmt.1	8.1 (Berkeley) 06/06/93
736581Sbostic.\"
843693Scael.Dd
943693Scael.Dt FMT 1
1050469Scael.Os
1143693Scael.Sh NAME
1243693Scael.Nm fmt
1343693Scael.Nd simple text formatter
1443693Scael.Sh SYNOPSIS
1543693Scael.Nm fmt
1650469Scael.Oo
1743693Scael.Ar goal
1843693Scael.Op Ar maximum
1950469Scael.Oc
2043693Scael.Op name ...
2143693Scael.Sh DESCRIPTION
2243693Scael.Nm Fmt
2319138Smckusickis a simple text formatter which reads the concatenation of input
2429544Smckusickfiles (or standard input if none are given) and produces on standard
2543693Scaeloutput a version of its input with lines as close to the
2643693Scael.Ar goal
2743693Scaellength
2843693Scaelas possible without exceeding the maximum.  The
2943693Scael.Ar goal
3043693Scaellength defaults
3129544Smckusickto 65 and the maximum to 75.  The spacing at the beginning of the
3229544Smckusickinput lines is preserved in the output, as are blank lines and
3329544Smckusickinterword spacing.
3443693Scael.Pp
3543693Scael.Nm Fmt
3619138Smckusickis meant to format mail messages prior to sending, but may also be useful
3719138Smckusickfor other simple tasks.
3819138SmckusickFor instance,
3919138Smckusickwithin visual mode of the
4043693Scael.Xr ex 1
4119138Smckusickeditor (e.g.
4243693Scael.Xr vi 1 )
4319138Smckusickthe command
4443693Scael.Pp
4543693Scael.Dl \&!}fmt
4643693Scael.Pp
4719138Smckusickwill reformat a paragraph,
4819138Smckusickevening the lines.
4943693Scael.Sh SEE ALSO
5043693Scael.Xr nroff 1 ,
5143693Scael.Xr mail 1
5243693Scael.Sh HISTORY
5350469ScaelThe
5450469Scael.Nm fmt
5550469Scaelcommand appeared in
5650469Scael.Bx 3 .
5750469Scael.\" .Sh AUTHOR
5850469Scael.\" Kurt Shoens
5950469Scael.\" .br
6050469Scael.\" Liz Allen (added goal length concept)
6143693Scael.Sh BUGS
6219138SmckusickThe program was designed to be simple and fast \- for more complex
6319138Smckusickoperations, the standard text processors are likely to be more appropriate.
64