X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/5dd6771b28c257af405d7248639ed0e3bcdce38b..94187a80bd60baab4b9c4b949ad820d730578123:/man/show.man diff --git a/man/show.man b/man/show.man index bdca14fc..4a0f5f48 100644 --- a/man/show.man +++ b/man/show.man @@ -1,31 +1,32 @@ -.\" +.TH SHOW %manext1% 2016-03-24 "%nmhversion%" +. .\" %nmhwarning% -.\" -.TH SHOW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%] +. .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 @@ -38,12 +39,16 @@ This command will display text messages in a nice, uniform format. It also allows you to configure the format of the displayed messages and which headers fields are shown. See the -.BR mhl (1) +.IR mhl (1) 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 @@ -68,7 +73,7 @@ contents) are processed and displayed by the command .BR mhshow . See the -.BR mhshow (1) +.IR mhshow (1) manual page for details about this command. This default can changed by defining the .I showmimeproc @@ -92,14 +97,15 @@ specify a transfer encoding (such as MIME quoted-printable or base64) or specify a character set that .B show doesn't believe -can be displayed natively. The environment variable -.B $MM_CHARSET +can be displayed natively. The appropriate +.IR locale (1) +environment variables should be set to the terminal's native character set to avoid gratuitous invocations of the .IR showmimeproc . -See the -.BR mh-profile (5) -man page for details about this environment variable. +See +.IR locale (1) +for details about these environment variables. .PP The option .B \-checkmime @@ -129,22 +135,20 @@ messages. It is equivalent to .IR cat . It is still accepted, but should be considered (somewhat) obsolete. .PP -If the environment variable -.B $NOMHNPROC -is set, the test for -non-text (MIME) messages will be disabled. This method is obsolete. -Use the -.B \-nocheckmime -switch instead. -.PP 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 @@ -158,26 +162,24 @@ 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 ^ ~ .nf @@ -189,22 +191,23 @@ from each sequence named by the profile entry. ^showproc:~^Program to show text (non-MIME) messages ^showmimeproc:~^Program to show non-text (MIME) messages .fi - .SH "SEE ALSO" -mhl(1), mhshow(1), more(1), next(1), prev(1), scan(1) - +.IR mhl (1), +.IR mhshow (1), +.IR next (1), +.IR prev (1), +.IR scan (1) .SH DEFAULTS .nf .RB ` +folder "' defaults to the current folder" .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 -message shown will become the current message. - +message selected will become the current message. .SH BUGS The .B \-header @@ -218,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 @@ -235,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 @@ -264,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