1SHOW(1) General Commands Manual SHOW(1)
2
3
4
6 show - display nmh messages
7
9 show [-help] [-version] [+folder] [msgs] [-draft] [-showproc program]
10 [-showmimeproc program] [-header | -noheader] [-checkmime |
11 -nocheckmime] [-concat | -noconcat] [switches for showproc or
12 showmimeproc]
13
15 show lists each of the specified messages to the standard output (typi‐
16 cally, the terminal).
17
18 By default, text (non-MIME) messages are filtered and displayed by the
19 nmh command mhl. This command will display text messages in a nice,
20 uniform format. It also allows you to configure the format of the dis‐
21 played messages and which headers fields are shown. See the mhl(1)
22 manual page for the details about this command. This default can be
23 changed by defining the showproc profile component. Any switches not
24 recognized by show, as well as -header and -noheader, are passed along
25 to that program. To override the default and the showproc profile com‐
26 ponent, use the -showproc program switch. For example, -showproc more
27 will cause the more program to list the messages with no reformatting.
28 Normally, this program is specified as the showproc in the user's
29 .mh_profile, rather than using a command line switch.
30
31 By default, non-text messages (MIME messages with multi-media contents)
32 are processed and displayed by the nmh command mhshow. See the
33 mhshow(1) manual page for details about this command. This default can
34 changed by defining the showmimeproc profile component. Any switches
35 not recognized by show are passed along to that program. To override
36 this default and the showmimeproc profile component, use the -showmime‐
37 proc program switch.
38
39 Note that in some cases, show may invoke the showmimeproc even for tex‐
40 tual contents. This will happen for text messages that specify a
41 transfer encoding (such as MIME quoted-printable or base64) or specify
42 a character set that show doesn't believe can be displayed natively.
43 The appropriate locale(1) environment variables should be set to the
44 terminal's native character set to avoid gratuitous invocations of the
45 showmimeproc. See the locale(1) man page for details about these envi‐
46 ronment variables.
47
48 The option -checkmime (set by default) instructs show to test if any of
49 the messages to be displayed are non-text (MIME) messages. If any are
50 non-text, they are displayed by the program showmimeproc, else they are
51 displayed by the program showproc. The option -nocheckmime disables
52 this test and instructs show to use showproc, regardless of whether any
53 of the messages are non-text (MIME) messages.
54
55 The -noshowproc switch will disable any formatting or paging of mes‐
56 sages. It is equivalent to -nocheckmime -showproc cat. It is still
57 accepted, but should be considered (somewhat) obsolete.
58
59 The -header switch tells show to display a one-line description of the
60 message being shown. This description includes the folder and the mes‐
61 sage number.
62
63 By default show will concatenate all content under one pager. If you
64 want each part to displayed separately, you can override the default
65 behavior with -noconcat.
66
67 If no `msgs' are specified, the current message is used. Although it
68 depends on the specific showproc or showmimeproc, in the default setup
69 when more than one message is specified, you will be prompted for a
70 <RETURN> prior to listing each message. Each message will be listed a
71 page at a time, and when the end of page is reached, the program will
72 wait for a <SPACE> or <RETURN>. If a <RETURN> is entered, it will
73 print the next line, whereas <SPACE> will print the next screenful.
74
75 If the standard output is not a terminal, no queries are made, and each
76 file is listed with a one-line header and two lines of separation.
77
78 “show -draft” will list the file <mh-dir>/draft if it exists.
79
80 If the profile entry “Unseen-Sequence” is present and non-empty, then
81 show will remove each of the messages shown from each sequence named by
82 the profile entry.
83
85 $HOME/.mh_profile The user profile
86
88 Path: To determine the user's nmh directory
89 Current-Folder: To find the default current folder
90 Unseen-Sequence: To name sequences denoting unseen messages
91 showproc: Program to show text (non-MIME) messages
92 showmimeproc: Program to show non-text (MIME) messages
93
95 mhl(1), mhshow(1), next(1), prev(1), scan(1)
96
98 `+folder' defaults to the current folder
99 `msgs' defaults to cur
100 `-checkmime'
101 `-header'
102 `-concat'
103
105 If a folder is given, it will become the current folder. The last mes‐
106 sage selected will become the current message.
107
109 The -header switch doesn't work when `msgs' expands to more than one
110 message. If the showproc is mhl, then this problem can be circumvented
111 by referencing the “messagename” field in the mhl format file.
112
113 show updates the user's context before showing the message. Hence show
114 will mark messages as seen prior to the user actually seeing them.
115 This is generally not a problem, unless the user relies on the “unseen”
116 messages mechanism, and interrupts show while it is showing “unseen”
117 messages.
118
119 If your showproc is mhl (the default), then show uses a built-in mhl:
120 it does not actually run the mhl program. Hence, if you define your
121 own showproc, don't call it mhl since show won't run it.
122
123 If your showproc is the pager more, then avoid running show in the
124 background with only its standard output piped to another process, as
125 in
126
127 show | imprint &
128
129 Due to a bug in more, show will go into a “tty input” state. To avoid
130 this problem, re-direct show's diagnostic output as well. For users of
131 csh:
132
133 show |& imprint &
134
135 For users of sh:
136
137 show 2>&1 | imprint &
138
139
140
141nmh-1.7.1 2016-03-24 SHOW(1)