X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/e99539ae6376c4b33e1a23f2ce50830c0d107786..39ecf70bb:/man/show.man?ds=inline diff --git a/man/show.man b/man/show.man index 04589fb6..1c82edb3 100644 --- a/man/show.man +++ b/man/show.man @@ -1,13 +1,15 @@ -.TH SHOW %manext1% "June 6, 2012" "%nmhversion%" -.\" +.TH SHOW %manext1% 2016-03-24 "%nmhversion%" +. .\" %nmhwarning% -.\" +. .SH NAME -show \- show (display) messages +show \- show (display) nmh messages .SH SYNOPSIS .HP 5 .na .B show +.RB [ \-help ] +.RB [ \-version ] .RI [ +folder ] .RI [ msgs ] .RB [ \-draft ] @@ -17,15 +19,14 @@ show \- show (display) messages .IR program ] .RB [ \-header " | " \-noheader ] .RB [ \-checkmime " | " \-nocheckmime ] +.RB [ \-concat " | " \-noconcat ] [switches\ for .I showproc or .IR showmimeproc ] -.RB [ \-version ] -.RB [ \-help ] .ad .SH DESCRIPTION -.B Show +.B show lists each of the specified messages to the standard output (typically, the terminal). .PP @@ -43,7 +44,11 @@ manual page for the details about this command. This default can be changed by defining the .I showproc profile component. Any switches not recognized by -.B show +.BR show , +as well as +.B \-header +and +.BR \-noheader , are passed along to that program. To override the default and the .I showproc @@ -59,7 +64,7 @@ program to list the messages with no reformatting. Normally, this program is specified as the .I showproc in the user's -.IR \&.mh\(ruprofile , +.IR \&.mh_profile , rather than using a command line switch. .PP By default, non-text messages (MIME messages with multi-media @@ -134,10 +139,16 @@ The .B \-header switch tells .B show -to display a one\-line +to display a one-line description of the message being shown. This description includes the folder and the message number. .PP +By default +.B show +will concatenate all content under one pager. If you want each part to +displayed separately, you can override the default behavior with +.B \-noconcat. +.PP If no `msgs' are specified, the current message is used. Although it depends on the specific .I showproc @@ -151,23 +162,23 @@ If a is entered, it will print the next line, whereas will print the next screenful. .PP If the standard output is not a terminal, no queries are made, and -each file is listed with a one\-line header and two lines of +each file is listed with a one-line header and two lines of separation. .PP .RB \*(lq "show \-draft" \*(rq -will list the file /draft if it +will list the file /draft if it exists. .PP If the profile entry \*(lqUnseen\-Sequence\*(rq is present and -non\-empty, then +non-empty, then .B show will remove each of the messages shown from each sequence named by the profile entry. .SH FILES .fc ^ ~ .nf -.ta \w'%etcdir%/ExtraBigFileName 'u -^$HOME/\&.mh\(ruprofile~^The user profile +.ta \w'%nmhetcdir%/ExtraBigFileName 'u +^$HOME/.mh_profile~^The user profile .fi .SH "PROFILE COMPONENTS" .fc ^ ~ @@ -192,6 +203,7 @@ from each sequence named by the profile entry. .RB ` msgs "' defaults to cur" .RB ` \-checkmime ' .RB ` \-header ' +.RB ` \-concat ' .fi .SH CONTEXT If a folder is given, it will become the current folder. The last @@ -209,7 +221,7 @@ be circumvented by referencing the \*(lqmessagename\*(rq field in the .B mhl format file. .PP -.B Show +.B show updates the user's context before showing the message. Hence .B show @@ -226,13 +238,13 @@ is (the default), then .B show uses -a built\-in +a built-in .BR mhl : it does not actually run the .B mhl program. Hence, if you define your own -.B showproc , +.BR showproc , don't call it .B mhl since @@ -255,7 +267,7 @@ show | imprint & Due to a bug in .BR more , show will go into a \*(lqtty input\*(rq state. -To avoid this problem, re\-direct +To avoid this problem, re-direct .BR show 's diagnostic output as well. For users of