Renamed -version switch to -Version to remove the conflict with -verbose.
[mmh] / man / mhl.man1
index a04464d..909db5c 100644 (file)
@@ -8,15 +8,13 @@ mhl \- produce formatted listings of nmh messages
 .HP 5
 .na
 .B mhl
-.RB [ \-folder
-.IR +folder ]
 .RB [ \-form
 .IR formfile ]
 .RB [ \-width
 .IR columns ]
 .RI [ files
 .IR \&... ]
-.RB [ \-version ]
+.RB [ \-Version ]
 .RB [ \-help ]
 .ad
 .SH DESCRIPTION
@@ -29,13 +27,6 @@ messages.  It is the default method of displaying text messages for
 (it is the default
 .IR showproc ).
 .PP
-If
-.B mhl
-is outputting to a terminal, then
-.B mhl
-will cause a pager to be placed between the terminal and
-.BR mhl .
-.PP
 The
 .B \-width
 .I width
@@ -64,23 +55,6 @@ tool, the
 switch does only take file names, but no format strings with a prepended
 equal sign `='.
 .PP
-Finally, the
-.B \-folder
-.I +folder
-switch sets the
-.B nmh
-folder name,
-which is used for the \*(lqmessagename:\*(rq field described below.  The
-environment variable
-.B $mhfolder
-is consulted for the default value,
-which
-.BR show ,
-.BR next ,
-and
-.B prev
-initialize appropriately.
-.PP
 .B Mhl
 operates in two phases: 1) read and parse the format file, and
 2) process each message (file).  During phase 1, an internal description
@@ -138,7 +112,7 @@ width).
 .RS 5
 .nf
 .ta \w'xxxxxxxxxxxxx  'u +\w'integer/G  'u
-.I variable    type    semantics
+.I "variable   type    semantics
 width  integer screen width or component width
 length integer component length
 offset integer positions to indent \*(lqcomponent: \*(rq
@@ -194,12 +168,9 @@ ignores=component,...
 specifies a list of components which are never output.
 .PP
 The component \*(lqMessageName\*(rq (case\-insensitive) will output the
-actual message name (file name) preceded by the folder name if one is
-specified or found in the environment.  The format is identical to that
-produced by the
-.B \-header
-option to
+message file name as a one-line header, similar to
 .BR show .
+E.g. ``(Message 42)''
 .PP
 The component \*(lqExtras\*(rq will output all of the components of the
 message which were not matched by explicit components, or included in
@@ -251,12 +222,7 @@ appropriate formatfield variable string.
 .fi
 
 .SH "PROFILE COMPONENTS"
-.fc ^ ~
-.nf
-.ta 2.4i
-.ta \w'ExtraBigProfileName  'u
-^Pager:~^Program to use as interactive front\-end
-.fi
+none
 
 .SH "SEE ALSO"
 show(1), ap(8), dp(8)