+.TH MHL %manext1% "September 14, 2014" "%nmhversion%"
.\"
.\" %nmhwarning%
.\"
-.TH MHL %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
mhl \- produce formatted listings of nmh messages
.SH SYNOPSIS
.HP 5
.na
-.B %libdir%/mhl
+.B %nmhlibexecdir%/mhl
+.RB [ \-help ]
+.RB [ \-version ]
.RB [ \-bell " | " \-nobell ]
.RB [ \-clear " | " \-noclear ]
.RB [ \-folder
.RB [ \-nofmtproc ]
.RI [ files
.IR \&... ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B Mhl
will first search for this file in the user's
.B nmh
directory, and will then search in the directory
-.IR %etcdir% .
+.IR %nmhetcdir% .
This default
can be changed by using the
.B \-form
leftadjust flag strip off leading whitespace on each
line of text
noleftadjust flag don't leftadjust
+rtrim flag trim whitespace at end of text lines
+nortrim flag retain whitespace at end of text
+ lines (default)
compress flag change newlines in text to spaces
nocompress flag don't compress
wrap flag Wrap lines that exceed width (default)
nonewline flag don't print newline at end of components
formatfield string format string for this component
(see below)
-decode flag decode text as RFC-2047 encoded
+decode flag decode text as RFC 2047 encoded
header field
addrfield flag field contains addresses
datefield flag field contains dates
.RE
.PP
The variable \*(lqformatfield\*(rq specifies a format string (see
-.BR mh\-format (5)).
+.IR mh\-format (5)).
The flag variables \*(lqaddrfield\*(rq and
\*(lqdatefield\*(rq (which are mutually exclusive), tell
.B mhl
.B mhl
does not apply any formatting string to fields
containing address or dates (see
-.BR mh\-mail (5)
+.IR mh\-mail (5)
for a list of these
fields). Note that this results in faster operation since
.B mhl
the filter has been run. The expected use of this is to filter a message
body to create more pleasing text to use in a reply message.
A suggested filter to use for
-.BR repl(1)
+.IR repl(1)
is as follows:
.PP
.RS 5
.I formatarg
option specifies a string that is used as an argument to the format filter.
This string is processed by
-.BR mh\-format (5)
+.IR mh\-format (5)
and all of the message components are available for use. Multiple
.I formatarg
options can be used to build up multiple arguments to the format filter.
.SH FILES
.fc ^ ~
.nf
-.ta \w'%etcdir%/ExtraBigFileName 'u
-^%etcdir%/mhl.format~^The message template
+.ta \w'%nmhetcdir%/ExtraBigFileName 'u
+^%nmhetcdir%/mhl.format~^The message template
^or <mh\-dir>/mhl.format~^Rather than the standard template
^$HOME/\&.mh\(ruprofile~^The user profile
.fi
-
.SH "PROFILE COMPONENTS"
.fc ^ ~
.nf
^formatproc:~^Program to use as a filter for components that
^^have the \*(lqformat\*(rq flag set.
.fi
-
.SH "SEE ALSO"
-show(1), ap(8), dp(8)
-
+.IR show (1),
+.IR ap (8),
+.IR dp (8)
.SH DEFAULTS
.nf
.RB ` \-bell '
.RB ` \-length\ 40 '
.RB ` \-width\ 80 '
.fi
-
.SH CONTEXT
None
-
.SH BUGS
There should be some way to pass `bell' and `clear' information to the
front\-end.