X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=man%2Fmhl.man;h=0f2c670b5972376dfd2c6f7d089c68c377090782;hb=d00b170aa19a82a22bf55516f2cdb33e26deca0c;hp=eff230f764476f3c436e4daaa8a21aebb1985112;hpb=3e151103c954aad7871a197b438b8d79d557e07e;p=mmh diff --git a/man/mhl.man b/man/mhl.man index eff230f..0f2c670 100644 --- a/man/mhl.man +++ b/man/mhl.man @@ -21,6 +21,9 @@ mhl \- produce formatted listings of nmh messages .RB [ \-moreproc .IR program ] .RB [ \-nomoreproc ] +.RB [ \-fmtproc +.IR program ] +.RB [ \-nofmtproc ] .RI [ files .IR \&... ] .RB [ \-version ] @@ -207,7 +210,7 @@ bell, clearscreen, width, length). .RS 5 .nf .ta \w'noclearscreen 'u +\w'integer/G 'u -.I variable type semantics +.I "variable type semantics" width integer screen width or component width length integer screen length or component length offset integer positions to indent \*(lqcomponent: \*(rq @@ -254,6 +257,7 @@ format flag Run component through formatproc filter (body only) noformat flag Do not run component through formatproc filter (default) +formatarg string Argument to format filter .fi .RE .PP @@ -325,7 +329,7 @@ the filter program specified by the .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 @@ -337,6 +341,23 @@ is as follows: .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 @@ -363,8 +384,8 @@ show(1), ap(8), dp(8) .nf .RB ` \-bell ' .RB ` \-noclear ' -.RB ` \-length 40 ' -.RB ` \-width 80 ' +.RB ` \-length\ 40 ' +.RB ` \-width\ 80 ' .fi .SH CONTEXT @@ -376,3 +397,6 @@ 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.