4 .TH INC %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
6 inc \- incorporate new mail
15 .RB [ \-changecur " | " \-nochangecur ]
20 .RB [ \-silent " | " \-nosilent ]
21 .RB [ \-truncate " | " \-notruncate ]
29 incorporates mail from the user's incoming mail drop into
34 You may specify which folder to use with
36 If no folder is specified, then
38 will use either the folder given by a (non\-empty)
40 entry in the user's profile, or the folder named
41 .RI \*(lq inbox \*(rq.
42 If the specified (or default) folder doesn't
43 exist, the user will be queried prior to its creation.
45 When the new messages are incorporated into the folder, they are assigned
46 numbers starting with the next highest number for the folder. As the
47 messages are processed, a
49 listing of the new mail is produced.
51 If the user's profile contains a
52 .RI \*(lq "Msg\-Protect: nnn" \*(rq
54 will be used as the protection on the newly created messages, otherwise
57 default of 0644 will be used. For all subsequent operations
58 on these messages, this initially assigned protection will be preserved.
63 is specified (usually as a default
64 switch in the profile), then
66 will append a header line and a
67 line per message to the end of the specified audit\-file with the format:
72 <scan line for first message>
73 <scan line for second message>
78 This is useful for keeping track of volume and source of incoming mail.
85 may also produce audits to this (or another) file, perhaps with
86 .RI \*(lq Message\-Id \*(rq
87 information to keep an exact correspondence
89 .RI \*(lq Audit\-file \*(rq
90 will be in the current directory unless a full path is specified.
93 will incorporate even improperly formatted messages into the
94 user's nmh folder, inserting a blank line prior to the offending component
95 and printing a comment identifying the bad message.
97 In all cases, the user's mail drop will be zeroed, unless the
102 .RI \*(lq Unseen\-Sequence \*(rq
103 is present and non\-empty, then
105 will add each of the newly incorporated messages to
106 each sequence named by the profile entry.
108 will not zero each sequence prior to adding messages.
110 The interpretation of the
116 switches is the same as in
122 switch, one can direct
124 to incorporate messages from a file other than the user's maildrop.
125 Note that the name file will NOT be zeroed, unless the
129 If the environment variable
133 uses it as the location of the user's maildrop instead of the default
137 switch still overrides this, however). If this
138 environment variable is not set, then
140 will consult the profile entry
141 .RI \*(lq MailDrop \*(rq
142 for this information. If the value found is
143 not absolute, then it is interpreted relative to the user's
145 directory. If the value is not found, then
147 will look in the standard system location for the user's maildrop.
153 to be quiet and not ask any questions at all. This is useful for putting
155 in the background and going on to other things.
160 .ta \w'%etcdir%/ExtraBigFileName 'u
161 ^$HOME/.mmh/profile~^The user profile
162 ^%mailspool%/$USER~^Location of mail drop
165 .SH "PROFILE COMPONENTS"
169 .ta \w'ExtraBigProfileName 'u
170 ^Path:~^To determine the user's mail storage
171 ^Alternate\-Mailboxes:~^To determine the user's mailboxes
172 ^Inbox:~^To determine the inbox, default \*(lqinbox\*(rq
173 ^Folder\-Protect:~^To set mode when creating a new folder
174 ^Msg\-Protect:~^To set mode when creating a new message and audit\-file
175 ^Unseen\-Sequence:~^To name sequences denoting unseen messages
179 mhmail(1), scan(1), mh\-mail(5), post(8)
183 .RB ` +folder "' defaulted by \*(lqInbox\*(rq above"
186 .RB ` \-form "' defaulted as described above"
188 .RB ` \-truncate "' if `" \-file " name' not given, `" \-notruncate "' otherwise"
189 .RB ` \-width "' defaulted to the width of the terminal"
193 The folder into which messages are being incorporated will become the
194 current folder. The first message incorporated will become the current
197 option is specified. This leaves the context ready for a
199 of the first new message.