X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/7f71991d47a863a1cb3f66a1d5df87f3bacb7828..c576ad2674c37a1c63f004c71049998f38854c64:/man/show.man diff --git a/man/show.man b/man/show.man index 57832c3f..4a0f5f48 100644 --- a/man/show.man +++ b/man/show.man @@ -1,31 +1,32 @@ -.TH SHOW %manext1% "February 8, 2015" "%nmhversion%" -.\" +.TH SHOW %manext1% 2016-03-24 "%nmhversion%" +. .\" %nmhwarning% -.\" +. .SH NAME -show \- show (display) messages +show \- display nmh messages .SH SYNOPSIS .HP 5 .na .B show +.RB [ \-help ] +.RB [ \-version ] .RI [ +folder ] .RI [ msgs ] .RB [ \-draft ] -.RB [\-showproc +.RB [ \-showproc .IR program ] .RB [ \-showmimeproc .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 @@ -63,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 @@ -102,9 +103,9 @@ environment variables should be set to the terminal's native character set to avoid gratuitous invocations of the .IR showmimeproc . -See the +See .IR locale (1) -man page for details about these environment variables. +for details about these environment variables. .PP The option .B \-checkmime @@ -138,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 @@ -155,15 +162,15 @@ 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. @@ -171,7 +178,7 @@ from each sequence named by the profile entry. .fc ^ ~ .nf .ta \w'%nmhetcdir%/ExtraBigFileName 'u -^$HOME/\&.mh\(ruprofile~^The user profile +^$HOME/.mh_profile~^The user profile .fi .SH "PROFILE COMPONENTS" .fc ^ ~ @@ -196,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 @@ -213,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 @@ -230,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 @@ -259,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