X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fshow.man1;h=b46712221fb62e1d8ed399b06646c882be17df94;hp=47cf7d00f9ca61ecbb47e7e48e2538e7cef9e5fc;hb=d1fefd9f614e4dc3cda16da6c69133c1b2005269;hpb=2d2016f0dfc9e036549ff035f0ae897c9b2d5fe4 diff --git a/man/show.man1 b/man/show.man1 index 47cf7d0..b467122 100644 --- a/man/show.man1 +++ b/man/show.man1 @@ -4,6 +4,10 @@ .TH SHOW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%] .SH NAME show \- show (display) messages +.PP +next \- show the next message +.PP +prev \- show the previous message .SH SYNOPSIS .HP 5 .na @@ -22,11 +26,29 @@ or .IR showmimeproc ] .RB [ \-version ] .RB [ \-help ] +.PP +.HP 5 +.B next +is equivalent to +.B show n +.PP +.HP 5 +.B prev +is equivalent to +.B show p .ad + .SH DESCRIPTION .B Show lists each of the specified messages to the standard output (typically, the terminal). +.B Next +and +.B prev +perform a +.B show +on the next or previous message in the specified +(or current) folder, respectively. .PP By default, text (non-MIME) messages are filtered and displayed by the @@ -39,14 +61,10 @@ the format of the displayed messages and which headers fields are shown. See the .BR 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 +command. Any switches not recognized by .B show are -passed along to that program. To override the default and the -.I showproc -profile component, use the +passed along to that program. To override the default, use the .B \-showproc .I program switch. For example, @@ -54,61 +72,40 @@ switch. For example, .I more will cause the .B more -program to list the messages with no reformatting. Normally, this -program is specified as the -.I showproc -in the user's profile, -rather than using a command line switch. +program to list the messages with no reformatting. .PP -By default, non-text messages (MIME messages with multi-media -contents) are processed and displayed by the +By default, MIME messages are processed and displayed by the .B nmh command .BR mhshow . See the .BR mhshow (1) manual page for details -about this command. This default can changed by defining the -.I showmimeproc -profile component. Any switches not recognized +about this command. +Any switches not recognized by .B show are passed along to that program. To override this -default and the -.B showmimeproc -profile component, use the +default, use the .B \-showmimeproc .I program switch. .PP -Note that in some cases, +Note that, .B show -may invoke the +will invoke the .I showmimeproc -even for textual contents. This will happen for text messages that -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 -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. +even for textual contents if the message has a MIME-Version header. .PP The option .B \-checkmime (set by default) instructs .B show -to -test if any of the messages to be displayed are non-text (MIME) -messages. If any are non-text, they are displayed by the program +to check if any of the messages contains a MIME-Version header. +If so, they are displayed by the .IR showmimeproc , -else they are displayed by the program -.IR showproc . +else they are displayed by the +.BR showproc . The option .B \-nocheckmime disables this test and instructs @@ -116,7 +113,7 @@ disables this test and instructs to use .IR showproc , regardless of whether -any of the messages are non-text (MIME) messages. +any of the messages are MIME messages. .PP The .B \-header @@ -126,18 +123,10 @@ to display a one\-line description of the message being shown. This description includes the folder and the message number. .PP -If no `msgs' are specified, the current message is used. Although -it depends on the specific -.I showproc -or -.IR showmimeproc , -in the default setup when more than one message is specified, you -will be prompted for a prior to listing each message. -Each message will be listed a page at a time, and when the end of -page is reached, the program will wait for a or . -If a is entered, it will print the next line, whereas - will print the next screenful. +If no `msgs' are specified, the current message is used. .PP +If the standard output is a terminal, output will be piped through +a pager. 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 separation. @@ -163,12 +152,10 @@ from each sequence named by the profile entry. ^Path:~^To determine the user's mail storage ^Current\-Folder:~^To find the default current folder ^Unseen\-Sequence:~^To name sequences denoting unseen messages -^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) +mhl(1), mhshow(1), more(1), scan(1) .SH DEFAULTS .nf @@ -237,3 +224,28 @@ For users of .RS 5 show 2>&1 | imprint & .RE +.PP +.B Next +and +.B prev +are really links to the +.B show +program. As a result, if +you make a link to +.B next +or +.B prev +and that link is not called +.B next +or +.BR prev , +your link will act like +.B show +instead. To circumvent this, add a +profile\-entry for the link to your +.B nmh +profile and add the argument +.I n +or +.I p +to the entry.