inc(1mh)inc(1mh)Nameinc - incorporate new mail
Syntaxinc [ +folder ] [ options ]
Description
Use to incorporate mail from your incoming maildrop into a folder.
Normally, incorporates new mail into your folder. If you supply a
+folder argument, mail is incorporated into the named folder instead of
your
The new messages being incorporated are numbered sequentially starting
with the next highest available number in the folder. If the specified
(or default) folder does not exist, will ask you whether you want to
create it. As the messages are processed, a listing of the new mail is
produced. See for details of the listing produced.
The folder into which messages are being incorporated will become the
current folder.
If your contains a Msg-Protect: entry, the mail system will use this as
the protection on the newly created messages; otherwise, it will use
the default of 0600. This means that messages created will have read
and write permission for the user only. During all operations on mes‐
sages, the mail system will preserve this initially assigned protection
for each message. You can also use to set a different protection on an
individual message; in this case the mail system will preserve the new
protection.
Note that will incorporate improperly formatted messages into your
folder, inserting a blank line prior to the offending component and
printing a comment identifying the bad message.
If the entry Unseen-Sequence is present in your profile, then will add
each of the newly incorporated messages to each sequence named by the
profile entry. This is similar to the Previous-Sequence ®profile entry
supported by all MH commands which take msg ®or msgs arguments. Note
that will not zero each sequence prior to adding messages.
If the environment variable $MAILDROP is set, then uses it as the loca‐
tion of your maildrop instead of the default. If this variable is not
set, then will consult the profile entry Maildrop ®for this informa‐
tion. If the value found is not absolute, then it is interpreted rela‐
tive to your Mail directory, which is usually If the value is not
found, then ®will look in the standard system location for your mail‐
drop. The -file ®option will override all of these.
Options-audit audit-file
-noaudit Keeps a record of all new mail that is incorporated. The
places a line in the named audit file for each message it
incorporates. This is useful for keeping track of the volume
and source of incoming mail.
This option is often set up in the file. See for more infor‐
mation on how to add entries to the file. If this option is
added to the it can be overridden using the -noaudit option
at the command line.
-changecur
-nochangecur
Makes the first new message the current message. This is the
default operation of If you want the current message to
remain as it was, use the -nochangecur option.
-file name
Incorporates mail from a named file. This is usually a file
other than your maildrop. Note that the mail system will not
zero the named file unless the -truncate switch is given.
-form formatfile
Controls the format of the display produced. The output of
is formatted according to the instructions in the named file.
The file must be an mhl format file; see for more informa‐
tion.
-format string
Controls the format of the display produced. The output of
is formatted according to the instructions given by the
string supplied. This must be a standard format string; see
for more information. If the string contains blank spaces,
the whole string must be enclosed in double quotes.
-help Prints list of the valid options for this command.
-silent
-nosilent Directs to be quiet and not ask any questions at all. This
is useful for putting in the background and going on to other
things.
-source file
Specifies the source from which mail is retrieved. The only
value allowed is file, which is the standard ULTRIX mail sys‐
tem. Additional values are supported only for use with other
mail systems.
-truncate
-notruncate
Zeroes your maildrop file when mail is fetched from it. This
is the default operation; your mail drop will be zeroed,
unless the -notruncate option is given.
-width Controls the width of the display produced by The default is
the width of the terminal; if no value is given, prints its
display as wide as the screen allows.
The defaults for this command are:
defaults to
-noaudit
-changecur
-nosilent
-truncate if the -file option is not given, -notruncate other‐
wise
-width defaults to the width of the terminal
Restrictions
For this version of MH, the -source option only supports the value
file. Additional values are supported for use only with other mail
systems.
Examples
The following example fetches incoming mail and places it in the folder
% inc +not_read
Profile Components
Path: To determine your Mail directory
Alternate-Mailboxes: To determine your mailboxes
Folder-Protect: To set mode when creating a new folder
Maildrop: To determine the location of your maildrop
Msg-Protect: To set mode when creating a new message
and audit-file
Unseen-Sequence: To name sequences denoting unseen messages
Files
The user profile.
The system customization file.
The user's maildrop.
See Alsochmod(1), mhl(1mh), mhmail(1mh), scan(1mh), mh-mail(5mh), post(8mh)inc(1mh)