mhshow: Add header and separation when displaying multiple messages.

[mmh] / man / mhshow.man1

diff --git a/man/mhshow.man1 b/man/mhshow.man1
index 79975ef..d3326ac 100644 (file)
--- a/man/mhshow.man1
+++ b/man/mhshow.man1
@@ -71,6 +71,14 @@ mail drop format to a folder of
 messages, see
 .BR inc (1)).
 .PP
 messages, see
 .BR inc (1)).
 .PP

+When displaying multiple messages,
+.B mhshow
+prepends each of them with a `>>> Message nnn' header,
+and separates the messages with two lines of space.
+This is similar to the way
+.B mhl
+acts on multiple files.
+.PP

 A part specification consists of a series of numbers separated by dots.
 For example, in a multipart content containing three parts, these
 would be named as 1, 2, and 3, respectively.  If part 2 was also a
 A part specification consists of a series of numbers separated by dots.
 For example, in a multipart content containing three parts, these
 would be named as 1, 2, and 3, respectively.  If part 2 was also a

@@ -118,6 +126,14 @@ non\-empty, then
 will remove each of the messages shown
 from each sequence named by the profile entry.
 .SS "Showing the Contents"
 will remove each of the messages shown
 from each sequence named by the profile entry.
 .SS "Showing the Contents"

+.B Mhshow
+prints messages in a convenient representation.
+If
+.B mhshow
+is outputting to a terminal, then
+a pager will be placed between the terminal and
+.BR mhshow .
+.PP

 The headers of each message are displayed with
 .B mhl
 using the standard format file
 The headers of each message are displayed with
 .B mhl
 using the standard format file

@@ -366,7 +382,7 @@ installation.
 ^Current\-Folder:~^To find the default current folder
 ^Unseen\-Sequence:~^To name sequences denoting unseen messages
 ^mhshow-show-<type>*~^Template for displaying contents
 ^Current\-Folder:~^To find the default current folder
 ^Unseen\-Sequence:~^To name sequences denoting unseen messages
 ^mhshow-show-<type>*~^Template for displaying contents

-^Pager:~^Default program to display text/plain content
+^Pager:~^Program to use as interactive front\-end

 .fi
 
 .SH "SEE ALSO"
 .fi
 
 .SH "SEE ALSO"