+.TH MHL %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.\"
.\" %nmhwarning%
.\"
-.TH MHL %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
mhl \- produce formatted listings of nmh messages
.SH SYNOPSIS
.RB [ \-moreproc
.IR program ]
.RB [ \-nomoreproc ]
+.RB [ \-fmtproc
+.IR program ]
+.RB [ \-nofmtproc ]
.RI [ files
.IR \&... ]
.RB [ \-version ]
(body only)
noformat flag Do not run component through
formatproc filter (default)
+formatarg string Argument to format filter
.fi
.RE
.PP
.IR formatproc
profile entry. This filter program is expected to read data on standard
input and output data on standard output. Currently the \*(lqformat\*(rq
-flag is only supported for the \(*lqbody\*(rq component. The component
+flag is only supported for the \*(lqbody\*(rq component. The component
name will be prefixed to the output
.IR after
the filter has been run. The expected use of this is to filter a message
.RS 5
body:component=">",overflowtext=">",overflowoffset=0,format,nowrap
.RE
+.PP
+The
+.B \-fmtproc
+and
+.B \-nofmtproc
+switches can be used to override the
+.I formatproc
+profile entry.
+.PP
+The
+.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)
+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
^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)
-
.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.
.PP
The \*(lqnonewline\*(rq option interacts badly with \*(lqcompress\*(rq
and \*(lqsplit\*(rq.
+.PP
+The \*(lqformat\*(rq option really should work on something other than the body
+component.