+++ /dev/null
-.\"
-.\" %nmhwarning%
-.\"
-.TH INC %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
-.SH NAME
-inc \- incorporate new mail
-.SH SYNOPSIS
-.HP 5
-.na
-.B inc
-.RI [ +folder ]
-.RB [ \-audit
-.IR audit\-file ]
-.RB [ \-noaudit ]
-.RB [ \-changecur " | " \-nochangecur ]
-.RB [ \-form
-.IR formfile ]
-.RB [ \-format
-.IR string ]
-.RB [ \-file
-.IR name ]
-.RB [ \-silent " | " \-nosilent ]
-.RB [ \-truncate " | " \-notruncate ]
-.RB [ \-width
-.IR columns ]
-.RB [ \-version ]
-.RB [ \-help ]
-.ad
-.SH DESCRIPTION
-.B Inc
-incorporates mail from the user's incoming mail drop into
-an
-.B nmh
-folder.
-.PP
-You may specify which folder to use with
-.IR +folder .
-If no folder is specified, then
-.B inc
-will use either the folder given by a (non\-empty)
-.RI \*(lq Inbox \*(rq
-entry in the user's profile, or the folder named
-.RI \*(lq inbox \*(rq.
-If the specified (or default) folder doesn't
-exist, the user will be queried prior to its creation.
-.PP
-When the new messages are incorporated into the folder, they are assigned
-numbers starting with the next highest number for the folder. As the
-messages are processed, a
-.B scan
-listing of the new mail is produced.
-.PP
-If the user's profile contains a
-.RI \*(lq "Msg\-Protect: nnn" \*(rq
-entry, it
-will be used as the protection on the newly created messages, otherwise
-the
-.B nmh
-default of 0644 will be used. For all subsequent operations
-on these messages, this initially assigned protection will be preserved.
-.PP
-If the switch
-.B \-audit
-.I audit\-file
-is specified (usually as a default
-switch in the profile), then
-.B inc
-will append a header line and a
-line per message to the end of the specified audit\-file with the format:
-.PP
-.RS 5
-.nf
-<<inc>> date
-<scan line for first message>
-<scan line for second message>
-<etc.>
-.fi
-.RE
-.PP
-This is useful for keeping track of volume and source of incoming mail.
-Eventually,
-.BR repl ,
-.BR forw ,
-.BR comp ,
-and
-.B dist
-may also produce audits to this (or another) file, perhaps with
-.RI \*(lq Message\-Id \*(rq
-information to keep an exact correspondence
-history.
-.RI \*(lq Audit\-file \*(rq
-will be in the current directory unless a full path is specified.
-.PP
-.B Inc
-will incorporate even improperly formatted messages into the
-user's nmh folder, inserting a blank line prior to the offending component
-and printing a comment identifying the bad message.
-.PP
-In all cases, the user's mail drop will be zeroed, unless the
-.B \-notruncate
-switch is given.
-.PP
-If the profile entry
-.RI \*(lq Unseen\-Sequence \*(rq
-is present and non\-empty, then
-.B inc
-will add each of the newly incorporated messages to
-each sequence named by the profile entry.
-.B Inc
-will not zero each sequence prior to adding messages.
-.PP
-The interpretation of the
-.B \-form
-.IR formatfile ,
-.B \-format
-.IR string ,
-and
-.B \-width
-.I columns
-switches is the same as in
-.BR scan .
-.PP
-By using the
-.B \-file
-.I name
-switch, one can direct
-.B inc
-to incorporate messages from a file other than the user's maildrop.
-Note that the name file will NOT be zeroed, unless the
-.B \-truncate
-switch is given.
-.PP
-If the environment variable
-.B $MAILDROP
-is set, then
-.B inc
-uses it as the location of the user's maildrop instead of the default
-(the
-.B -file
-.I name
-switch still overrides this, however). If this
-environment variable is not set, then
-.B inc
-will consult the profile entry
-.RI \*(lq MailDrop \*(rq
-for this information. If the value found is
-not absolute, then it is interpreted relative to the user's
-.B nmh
-directory. If the value is not found, then
-.B inc
-will look in the standard system location for the user's maildrop.
-.PP
-The
-.B \-silent
-switch directs
-.B inc
-to be quiet and not ask any questions at all. This is useful for putting
-.B inc
-in the background and going on to other things.
-
-.SH FILES
-.fc ^ ~
-.nf
-.ta \w'%etcdir%/ExtraBigFileName 'u
-^$HOME/.mmh/profile~^The user profile
-^%etcdir%/mts.conf~^nmh mts configuration file
-^%mailspool%/$USER~^Location of mail drop
-.fi
-
-.SH "PROFILE COMPONENTS"
-.fc ^ ~
-.nf
-.ta 2.4i
-.ta \w'ExtraBigProfileName 'u
-^Path:~^To determine the user's mail storage
-^Alternate\-Mailboxes:~^To determine the user's mailboxes
-^Inbox:~^To determine the inbox, default \*(lqinbox\*(rq
-^Folder\-Protect:~^To set mode when creating a new folder
-^Msg\-Protect:~^To set mode when creating a new message and audit\-file
-^Unseen\-Sequence:~^To name sequences denoting unseen messages
-.fi
-
-.SH "SEE ALSO"
-mhmail(1), scan(1), mh\-mail(5), post(8)
-
-.SH DEFAULTS
-.nf
-.RB ` +folder "' defaulted by \*(lqInbox\*(rq above"
-.RB ` \-noaudit '
-.RB ` \-changecur '
-.RB ` \-format "' defaulted as described above"
-.RB ` \-nosilent '
-.RB ` \-truncate "' if `" \-file " name' not given, `" \-notruncate "' otherwise"
-.RB ` \-width "' defaulted to the width of the terminal"
-.fi
-
-.SH CONTEXT
-The folder into which messages are being incorporated will become the
-current folder. The first message incorporated will become the current
-message, unless the
-.B \-nochangecur
-option is specified. This leaves the context ready for a
-.B show
-of the first new message.
-
-.SH BUGS
-The argument to the
-.B \-format
-switch must be interpreted as a single
-token by the shell that invokes
-.BR inc .
-Therefore, one must usually place the argument to this switch inside
-double\-quotes.
projects / mmh / blobdiff