X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/95e9c4e6befb17ca3e691c26f024fb55eeae5e31..9cca3d060843239d619fa41168cb6342d6ac5461:/man/show.man diff --git a/man/show.man b/man/show.man index fde9b433..89a5719e 100644 --- a/man/show.man +++ b/man/show.man @@ -1,4 +1,4 @@ -.TH SHOW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%] +.TH SHOW %manext1% "March 24, 2016" "%nmhversion%" .\" .\" %nmhwarning% .\" @@ -8,6 +8,8 @@ show \- show (display) messages .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 @@ -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 -.IR mh-profile (5) -man page for details about this environment variable. +.IR locale (1) +man page for details about these environment variables. .PP The option .B \-checkmime @@ -137,6 +143,12 @@ 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 @@ -165,7 +177,7 @@ from each sequence named by the profile entry. .SH FILES .fc ^ ~ .nf -.ta \w'%etcdir%/ExtraBigFileName 'u +.ta \w'%nmhetcdir%/ExtraBigFileName 'u ^$HOME/\&.mh\(ruprofile~^The user profile .fi .SH "PROFILE COMPONENTS" @@ -191,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 @@ -208,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