1SHOW(1)                            [nmh-1.3]                           SHOW(1)
2
3
4

NAME

6       show - show (display) messages
7

SYNOPSIS

9       show [+folder] [msgs] [-draft] [-showproc program] [-showmimeproc pro‐
10            gram] [-header | -noheader] [-checkmime | -nocheckmime]
11            [switches for showproc or showmimeproc] [-version] [-help]
12

DESCRIPTION

14       Show lists each of the specified messages to the standard output (typi‐
15       cally, the terminal).
16
17       By default, text (non-MIME) messages are filtered and displayed by  the
18       nmh  command  mhl.   This command will display text messages in a nice,
19       uniform format.  It also allows you to configure the format of the dis‐
20       played  messages  and  which  headers fields are shown.  See the mhl(1)
21       manual page for the details about this command.  This  default  can  be
22       changed  by  defining the showproc profile component.  Any switches not
23       recognized by show are passed along to that program.  To  override  the
24       default  and  the showproc profile component, use the -showproc program
25       switch.  For example, -showproc more will cause  the  more  program  to
26       list  the  messages  with  no  reformatting.  Normally, this program is
27       specified as the showproc in the user's .mh_profile, rather than  using
28       a command line switch.
29
30       By default, non-text messages (MIME messages with multi-media contents)
31       are processed and  displayed  by  the  nmh  command  mhshow.   See  the
32       mhshow(1) manual page for details about this command.  This default can
33       changed by defining the showmimeproc profile component.   Any  switches
34       not  recognized  by show are passed along to that program.  To override
35       this default and the showmimeproc profile component, use the -showmime‐
36       proc program switch.
37
38       Note that in some cases, show may invoke the showmimeproc even for tex‐
39       tual contents.  This will happen  for  text  messages  that  specify  a
40       transfer  encoding (such as MIME quoted-printable or base64) or specify
41       a character set that show doesn't believe can  be  displayed  natively.
42       The  environment  variable  $MM_CHARSET should be set to the terminal's
43       native character set to avoid gratuitous invocations of  the  showmime‐
44       proc.   See  the mh-profile(5) man page for details about this environ‐
45       ment variable.
46
47       The option -checkmime (set by default) instructs show to test if any of
48       the  messages to be displayed are non-text (MIME) messages.  If any are
49       non-text, they are displayed by the program showmimeproc, else they are
50       displayed  by  the  program showproc.  The option -nocheckmime disables
51       this test and instructs show to use showproc, regardless of whether any
52       of the messages are non-text (MIME) messages.
53
54       The  -noshowproc  switch  will disable any formatting or paging of mes‐
55       sages.  It is equivalent to -nocheckmime -showproc cat.   It  is  still
56       accepted, but should be considered (somewhat) obsolete.
57
58       If  the  environment  variable $NOMHNPROC is set, the test for non-text
59       (MIME) messages will be disabled.  This method is  obsolete.   Use  the
60       -nocheckmime switch instead.
61
62       The  -header switch tells show to display a one-line description of the
63       message being shown.  This description includes the folder and the mes‐
64       sage number.
65
66       If  no  `msgs' are specified, the current message is used.  Although it
67       depends on the specific showproc or showmimeproc, in the default  setup
68       when  more  than  one  message is specified, you will be prompted for a
69       <RETURN> prior to listing each message.  Each message will be listed  a
70       page  at  a time, and when the end of page is reached, the program will
71       wait for a <SPACE> or <RETURN>.  If a  <RETURN>  is  entered,  it  will
72       print the next line, whereas <SPACE> will print the next screenful.
73
74       If the standard output is not a terminal, no queries are made, and each
75       file is listed with a one-line header and two lines of separation.
76
77show -draft” will list the file <mh-dir>/draft if it exists.
78
79       If the profile entry “Unseen-Sequence” is present and  non-empty,  then
80       show will remove each of the messages shown from each sequence named by
81       the profile entry.
82
83

FILES

85       $HOME/.mh_profile          The user profile
86
87

PROFILE COMPONENTS

89       Path:                To determine the user's nmh directory
90       Current-Folder:      To find the default current folder
91       Unseen-Sequence:     To name sequences denoting unseen messages
92       showproc:            Program to show text (non-MIME) messages
93       showmimeproc:        Program to show non-text (MIME) messages
94
95

SEE ALSO

97       mhl(1), mhshow(1), more(1), next(1), prev(1), scan(1)
98
99

DEFAULTS

101       `+folder' defaults to the current folder
102       `msgs' defaults to cur
103       `-checkmime'
104       `-header'
105
106

CONTEXT

108       If a folder is given, it will become the current folder.  The last mes‐
109       sage shown will become the current message.
110
111

BUGS

113       The  -header  switch  doesn't work when `msgs' expands to more than one
114       message.  If the showproc is mhl, then this problem can be circumvented
115       by referencing the “messagename” field in the mhl format file.
116
117       Show updates the user's context before showing the message.  Hence show
118       will mark messages as seen prior to  the  user  actually  seeing  them.
119       This is generally not a problem, unless the user relies on the “unseen”
120       messages mechanism, and interrupts show while it  is  showing  “unseen”
121       messages.
122
123       If  your  showproc is mhl (the default), then show uses a built-in mhl:
124       it does not actually run the mhl program.  Hence, if  you  define  your
125       own showproc , don't call it mhl since show won't run it.
126
127       If  your  showproc  is  the  pager more, then avoid running show in the
128       background with only its standard output piped to another  process,  as
129       in
130
131            show | imprint &
132
133       Due  to a bug in more, show will go into a “tty input” state.  To avoid
134       this problem, re-direct show's diagnostic output as well.  For users of
135       csh:
136
137            show |& imprint &
138
139       For users of sh:
140
141            show 2>&1 | imprint &
142
143
144
145MH.6.8                            1 June 2008                          SHOW(1)
Impressum