4 .TH SCAN %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
6 scan \- produce a one line per message scan listing
13 .RB [ \-clear " | " \-noclear ]
20 .RB [ \-reverse " | " \-noreverse ]
28 produces a one\-line\-per\-message listing of the specified
29 folder or messages. Each
31 line contains the message number
32 (name), the date, the \*(lqFrom:\*(rq field, the \*(lqSubject\*(rq field,
33 and, if room allows, some of the body of the message. For example:
37 .ta \w'15+- 'u +\w'07/\|05x 'u +\w'Dcrocker 'u
38 15+ 10/\|05 crocker nned\0\0<<Last week I asked some of
39 16\- 10/\|05 crocker message id format\0\0\<<I recommend
40 18 10/\|06 brien Re: Exit status from mkdir
41 19 10/\|07*brien \*(lqscan\*(rq listing format in nmh
45 The `+' on message 15 indicates that it is the current message.
47 The `\-' on message 16 indicates that it has been replied to, as indicated
48 by a \*(lqReplied:\*(rq component (produced by the
55 The `*' on message 19 indicates that no \*(lqDate:\*(rq header was
56 present. The time of last modification of the message is given instead.
58 If there is sufficient room left on the
61 subject, the line will be filled with text from the body, preceded by
62 \*(lq<<\*(rq, and terminated by \*(lq>>\*(rq if the body is sufficiently short.
64 actually reads each of the specified messages and parses them to extract
65 the desired fields. During parsing, appropriate error messages will be
66 produced if there are format errors in any of the messages.
70 will decode RFC-2047 (MIME) encoding in
73 will only decode these fields if your
74 terminal can natively display the character set used in the encoding.
75 You should set the MM_CHARSET environment variable to your native
76 character set, if it is not US-ASCII. See the mh-profile(5) man
77 page for details about this environment variable.
83 list the messages in reverse
89 switch allows the user to obtain a
91 listing of a maildrop file as produced by
94 includes every message in the file (you can't scan individual messages).
97 is ignored with this option.
102 may be used to specify the width of
103 the scan line. The default is to use the width of the terminal.
112 will consult the environment variables
116 to determine your terminal type in order
117 to find out how to clear the screen prior to exiting. If the
121 output is not directed to a terminal
122 (e.g., a pipe or a file), then
124 will send a formfeed prior
127 For example, the command:
130 (scan \-clear ; show all \-show pr \-f) | lpr
133 produces a scan listing of the current folder, followed by a formfeed,
134 followed by a formatted listing of all messages in the folder, one
136 .RB \*(lq "\-show\ pr\ \-f" \*(rq
137 will cause the messages to be
138 concatenated, separated by a one\-line header and two blank lines.
140 To override the output format used by
148 switches are used. This permits individual fields of
149 the scan listing to be extracted with ease. The string is simply a format
150 string and the file is simply a format file. See
154 In addition to the standard
158 also recognizes the following additional
164 .ta \w'Dtimenow 'u +\w'Returns 'u
165 .I Escape Returns Description
166 body string the (compressed) first part of the body
167 dtimenow date the current date
168 folder string the name of the current folder
172 If no date header is present in the message, the
177 will return values for the date of last
178 modification of the message file itself. This feature is handy for
179 scanning a draft folder, as message drafts usually aren't allowed
180 to have dates in them.
185 context prior to starting the listing,
186 so interrupting a long
188 listing preserves the new context.
190 purists hate this idea.
195 .ta \w'%etcdir%/ExtraBigFileName 'u
196 ^$HOME/.mmh/profile~^The user profile
199 .SH "PROFILE COMPONENTS"
203 .ta \w'ExtraBigProfileName 'u
204 ^Path:~^To determine the user's mail storage
205 ^Alternate\-Mailboxes:~^To determine the user's mailboxes
206 ^Current\-Folder:~^To find the default current folder
210 inc(1), pick(1), show(1), mh\-format(5)
214 .RB ` +folder "' defaults to the current folder"
215 .RB ` msgs "' defaults to all"
216 .RB ` \-format "' defaulted as described above"
217 .RB ` \-width "' defaulted to the width of the terminal"
221 If a folder is given, it will become the current folder.
226 switch must be interpreted as a single
227 token by the shell that invokes
229 Therefore, one must usually
230 place the argument to this switch inside double\-quotes.
237 contents of the first message header
240 corresponding component name; any following headers with the same
241 component name are ignored.