Manpage SEE ALSO cleanup.
[mmh] / man / mhl.man
index 5c0af06..7fc4c1f 100644 (file)
@@ -1,7 +1,7 @@
+.TH MHL %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .\"
 .\" %nmhwarning%
 .\"
 .\"
 .\" %nmhwarning%
 .\"
-.TH MHL %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 mhl \- produce formatted listings of nmh messages
 .SH SYNOPSIS
 .SH NAME
 mhl \- produce formatted listings of nmh messages
 .SH SYNOPSIS
@@ -21,6 +21,9 @@ mhl \- produce formatted listings of nmh messages
 .RB [ \-moreproc
 .IR program ]
 .RB [ \-nomoreproc ]
 .RB [ \-moreproc
 .IR program ]
 .RB [ \-nomoreproc ]
+.RB [ \-fmtproc
+.IR program ]
+.RB [ \-nofmtproc ]
 .RI [ files
 .IR \&... ]
 .RB [ \-version ]
 .RI [ files
 .IR \&... ]
 .RB [ \-version ]
@@ -254,6 +257,7 @@ format      flag    Run component through formatproc filter
                (body only)
 noformat       flag    Do not run component through
                formatproc filter (default)
                (body only)
 noformat       flag    Do not run component through
                formatproc filter (default)
+formatarg      string  Argument to format filter
 .fi
 .RE
 .PP
 .fi
 .RE
 .PP
@@ -337,6 +341,23 @@ is as follows:
 .RS 5
 body:component=">",overflowtext=">",overflowoffset=0,format,nowrap
 .RE
 .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
 .SH FILES
 .fc ^ ~
 .nf
@@ -345,7 +366,6 @@ body:component=">",overflowtext=">",overflowoffset=0,format,nowrap
 ^or <mh\-dir>/mhl.format~^Rather than the standard template
 ^$HOME/\&.mh\(ruprofile~^The user profile
 .fi
 ^or <mh\-dir>/mhl.format~^Rather than the standard template
 ^$HOME/\&.mh\(ruprofile~^The user profile
 .fi
-
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf
@@ -355,10 +375,10 @@ body:component=">",overflowtext=">",overflowoffset=0,format,nowrap
 ^formatproc:~^Program to use as a filter for components that
 ^^have the \*(lqformat\*(rq flag set.
 .fi
 ^formatproc:~^Program to use as a filter for components that
 ^^have the \*(lqformat\*(rq flag set.
 .fi
-
 .SH "SEE ALSO"
 .SH "SEE ALSO"
-show(1), ap(8), dp(8)
-
+.IR show (1),
+.IR ap (8),
+.IR dp (8)
 .SH DEFAULTS
 .nf
 .RB ` \-bell '
 .SH DEFAULTS
 .nf
 .RB ` \-bell '
@@ -366,13 +386,14 @@ show(1), ap(8), dp(8)
 .RB ` \-length\ 40 '
 .RB ` \-width\ 80 '
 .fi
 .RB ` \-length\ 40 '
 .RB ` \-width\ 80 '
 .fi
-
 .SH CONTEXT
 None
 .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.
 .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.