/usr/share/elvis/manual/elvfmt.man is in elvis-common 2.2.0-11.1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 | .TH ELVFMT 1 "" "" "User commands"
.SH NAME
elvfmt \- adjust line-length for paragraphs of text
.SH SYNOPSIS
.ad l
.B elvfmt
.RB [ \-w
.I width
|
.BR \-\fIwidth ]
.RB [ \-s ]
.RB [ \-c ]
.RB [ \-i
.IR chars ]
.RB [ \-C ]
.RB [ \-M ]
.RI [ file ]...
.ad b
.SH VERSION
This page describes the
.B Elvis 2.2_0
version of
.BR elvfmt .
See
.BR elvis (1).
.SH DESCRIPTION
.B elvfmt
is a simple text formatter.
It inserts or deletes newlines, as necessary, to make all lines in a
paragraph be approximately the same width.
It preserves indentation and word spacing.
.PP
If you don't name any files on the command line,
then
.B elvfmt
will read from stdin.
.PP
It is typically used from within
.BR vi (1)
or
.BR elvis (1)
to adjust the line breaks
in a single paragraph.
To do this, move the cursor to the top of the paragraph,
type "!}elvfmt", and
hit <Return>.
.SH OPTIONS
.IP "\fB\-w\fP \fIwidth\fP or \fB\-\fP\fIwidth\fP"
Use a line width of \fIwidth\fP characters instead of the default
of 72 characters.
.IP \fB\-s\fP
Don't join lines shorter than the line width to fill paragraphs.
.IP \fB\-c\fP
Try to be smarter about crown margins.
Specifically, this tells
.B elvfmt
to expect the first line of each paragraph to have a different
indentation than subsequent lines.
If text from the first input line is wrapped onto the second output line, then
.B elvfmt
will scan ahead to figure out what indentation it should use for the second
output line, instead of reusing the first line's indentation.
.IP "\fB\-i\fP \fIchars\fP"
Allow the indentation text to include any character from
.IR chars ,
in addition to spaces and tabs.
You should quote the
.I chars
list to protect it from the shell.
.IP "\fB\-C\fP and \fB\-M\fP"
These are shortcuts for combinations of other flags.
.RB \" \-C \"
is short for
.RB \" "\-c \-i'/*'" \"
and is useful for reformatting C/C++ comments.
.RB \" \-M \"
is short for
.RB \" \-i'>' \"
and is useful for reformatting email messages.
.SH "SEE ALSO"
.BR vi (1),
.BR elvis (1)
.SH AUTHOR
Steve Kirkendall
.br
kirkenda@cs.pdx.edu
|