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
42 If the specified (or default) folder doesn't
43 exist, the user will (in
45 mode) 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 ` "Msg\-Protect: nnn" '
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
89 information to keep an exact correspondence
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 mh 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 ` Unseen\-Sequence '
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
118 switches is the same as in
124 switch, one can direct
126 to incorporate messages from a file other than the user's maildrop.
133 will read messages from standard input.
134 Note that the named file will NOT be zeroed, unless the
138 If the environment variable
142 uses it as the location of the user's maildrop instead of the default
146 switch still overrides this, however). If this
147 environment variable is not set, then
149 will consult the profile entry
151 for this information. If the value found is
152 not absolute, then it is interpreted relative to the user's
154 directory. If the value is not found, then
156 will look in the standard system location for the user's maildrop.
162 to be quiet and not ask any questions at all. This is useful for putting
164 in the background and going on to other things.
169 .ta \w'%etcdir%/ExtraBigFileName 'u
170 ^$HOME/.mmh/profile~^The user profile
171 ^%mailspool%/$USER~^Location of mail drop
174 .SH "PROFILE COMPONENTS"
178 .ta \w'ExtraBigProfileName 'u
179 ^Path:~^To determine the user's mail storage
180 ^Alternate\-Mailboxes:~^To determine the user's mailboxes
181 ^Inbox:~^To determine the inbox, default `inbox'
182 ^Folder\-Protect:~^To set mode when creating a new folder
183 ^Msg\-Protect:~^To set mode when creating a new message and audit\-file
184 ^Unseen\-Sequence:~^To name sequences denoting unseen messages
192 .RB ` +folder "' defaulted by `Inbox' above"
195 .RB ` \-form "' defaulted as described above"
197 .RB ` \-truncate "' if `" \-file " name' not given, `" \-notruncate "' otherwise"
198 .RB ` \-width "' defaulted to the width of the terminal"
202 The folder into which messages are being incorporated will become the
203 current folder. The first message incorporated will become the current
206 option is specified. This leaves the context ready for a
208 of the first new message.