4 .TH INC %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
6 inc \- incorporate new mail
15 .RB [ \-changecur " | " \-nochangecur ]
22 .RB [ \-silent " | " \-nosilent ]
23 .RB [ \-truncate " | " \-notruncate ]
31 incorporates mail from the user's incoming mail drop into
36 You may specify which folder to use with
38 If no folder is specified, then
40 will use either the folder given by a (non\-empty)
42 entry in the user's profile, or the folder named
43 .RI \*(lq inbox \*(rq.
44 If the specified (or default) folder doesn't
45 exist, the user will be queried prior to its creation.
47 When the new messages are incorporated into the folder, they are assigned
48 numbers starting with the next highest number for the folder. As the
49 messages are processed, a
51 listing of the new mail is produced.
53 If the user's profile contains a
54 .RI \*(lq "Msg\-Protect: nnn" \*(rq
56 will be used as the protection on the newly created messages, otherwise
59 default of 0644 will be used. For all subsequent operations
60 on these messages, this initially assigned protection will be preserved.
65 is specified (usually as a default
66 switch in the profile), then
68 will append a header line and a
69 line per message to the end of the specified audit\-file with the format:
74 <scan line for first message>
75 <scan line for second message>
80 This is useful for keeping track of volume and source of incoming mail.
87 may also produce audits to this (or another) file, perhaps with
88 .RI \*(lq Message\-Id \*(rq
89 information to keep an exact correspondence
91 .RI \*(lq Audit\-file \*(rq
92 will be in the current directory unless a full path is specified.
95 will incorporate even improperly formatted messages into the
96 user's nmh folder, inserting a blank line prior to the offending component
97 and printing a comment identifying the bad message.
99 In all cases, the user's mail drop will be zeroed, unless the
104 .RI \*(lq Unseen\-Sequence \*(rq
105 is present and non\-empty, then
107 will add each of the newly incorporated messages to
108 each sequence named by the profile entry.
110 will not zero each sequence prior to adding messages.
112 The interpretation of the
120 switches is the same as in
126 switch, one can direct
128 to incorporate messages from a file other than the user's maildrop.
129 Note that the name file will NOT be zeroed, unless the
133 If the environment variable
137 uses it as the location of the user's maildrop instead of the default
141 switch still overrides this, however). If this
142 environment variable is not set, then
144 will consult the profile entry
145 .RI \*(lq MailDrop \*(rq
146 for this information. If the value found is
147 not absolute, then it is interpreted relative to the user's
149 directory. If the value is not found, then
151 will look in the standard system location for the user's maildrop.
157 to be quiet and not ask any questions at all. This is useful for putting
159 in the background and going on to other things.
164 .ta \w'%etcdir%/ExtraBigFileName 'u
165 ^$HOME/.mmh/profile~^The user profile
166 ^%mailspool%/$USER~^Location of mail drop
169 .SH "PROFILE COMPONENTS"
173 .ta \w'ExtraBigProfileName 'u
174 ^Path:~^To determine the user's mail storage
175 ^Alternate\-Mailboxes:~^To determine the user's mailboxes
176 ^Inbox:~^To determine the inbox, default \*(lqinbox\*(rq
177 ^Folder\-Protect:~^To set mode when creating a new folder
178 ^Msg\-Protect:~^To set mode when creating a new message and audit\-file
179 ^Unseen\-Sequence:~^To name sequences denoting unseen messages
183 mhmail(1), scan(1), mh\-mail(5), post(8)
187 .RB ` +folder "' defaulted by \*(lqInbox\*(rq above"
190 .RB ` \-format "' defaulted as described above"
192 .RB ` \-truncate "' if `" \-file " name' not given, `" \-notruncate "' otherwise"
193 .RB ` \-width "' defaulted to the width of the terminal"
197 The folder into which messages are being incorporated will become the
198 current folder. The first message incorporated will become the current
201 option is specified. This leaves the context ready for a
203 of the first new message.
208 switch must be interpreted as a single
209 token by the shell that invokes
211 Therefore, one must usually place the argument to this switch inside