X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/cbce5e434f84af560946e16709d3c2ad10eb8942..4ac978448:/man/show.man?ds=sidebyside diff --git a/man/show.man b/man/show.man index a7117014..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 @@ -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 @@ -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. +.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" @@ -180,13 +192,18 @@ from each sequence named by the profile entry. ^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 @@ -204,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