xref: /illumos-gate/usr/src/man/man1/fmt.1 (revision bbf21555)
te
Copyright 1989 AT&T Copyright (c) 1997, Sun Microsystems, Inc. All Rights Reserved
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
FMT 1 "May 9, 1997"
NAME
fmt - simple text formatters
SYNOPSIS

fmt [-cs] [-w width | -width] [inputfile]...
DESCRIPTION

fmt is a simple text formatter that fills and joins lines to produce output lines of (up to) the number of characters specified in the -w width option. The default width is 72. fmt concatenates the inputfiles listed as arguments. If none are given, fmt formats text from the standard input.

Blank lines are preserved in the output, as is the spacing between words. fmt does not fill nor split lines beginning with a `.' (dot), for compatibility with nroff(1). Nor does it fill or split a set of contiguous non-blank lines which is determined to be a mail header, the first line of which must begin with "From".

Indentation is preserved in the output, and input lines with differing indentation are not joined (unless -c is used).

fmt can also be used as an in-line text filter for vi(1). The vi command:

!}fmt

reformats the text between the cursor location and the end of the paragraph.

OPTIONS
-c

Crown margin mode. Preserve the indentation of the first two lines within a paragraph, and align the left margin of each subsequent line with that of the second line. This is useful for tagged paragraphs.

-s

Split lines only. Do not join short lines to form longer ones. This prevents sample lines of code, and other such formatted text, from being unduly combined.

-w width | -width

Fill output lines to up to width columns.

OPERANDS
inputfile

Input file.

ENVIRONMENT VARIABLES

See environ(7) for a description of the LC_CTYPE environment variable that affects the execution of fmt.

SEE ALSO

nroff (1), vi (1), attributes (7), environ (7)

NOTES

The -width option is acceptable for BSD compatibility, but it may go away in future releases.