inc(1mh)
Name
inc − incorporate new mail
Syntax
inc [ +folder ] [ options ]
Description
Use inc to incorporate mail from your incoming maildrop into a folder.
Normally, inc incorporates new mail into your +inbox folder. If you supply a +folder argument, mail is incorporated into the named folder instead of your +inbox.
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, inc will ask you whether you want to create it. As the messages are processed, a scan listing of the new mail is produced. See scan() for details of the listing produced.
The folder into which messages are being incorporated will become the current folder.
If your .mh_profile 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 messages, the mail system will preserve this initially assigned protection for each message. You can also use chmod() to set a different protection on an individual message; in this case the mail system will preserve the new protection.
Note that inc 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 inc 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 inc will not zero each sequence prior to adding messages.
If the environment variable $MAILDROP is set, then inc uses it as the location of your maildrop instead of the default. If this variable is not set, then inc will consult the profile entry Maildrop for this information. If the value found is not absolute, then it is interpreted relative to your Mail directory, which is usually $HOME/Mail. If the value is not found, then inc will look in the standard system location for your maildrop. The −file option will override all of these.
Options
−audit audit-file
−noauditKeeps a record of all new mail that is incorporated. The inc places a scan 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 .mh_profile file. See mh_profile() for more information on how to add entries to the file. If this option is added to the .mh_profile, 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 inc. If you want the current message to remain as it was, use the −nochangecur option.
−file nameIncorporates 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 inc is formatted according to the instructions in the named file. The file must be an mhl format file; see mh-format() for more information.
−format string
Controls the format of the display produced. The output of inc is formatted according to the instructions given by the string supplied. This must be a standard format string; see mh-format() for more information. If the string contains blank spaces, the whole string must be enclosed in double quotes.
−helpPrints list of the valid options for this command.
−silent
−nosilentDirects inc to be quiet and not ask any questions at all. This is useful for putting inc 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 system. 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.
−widthControls the width of the display produced by inc. The default is the width of the terminal; if no value is given, inc prints its display as wide as the screen allows.
The defaults for this command are:
+folder defaults to +inbox
−noaudit
−changecur
−nosilent
−truncate if the −file option is not given, −notruncate otherwise
−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 +not_read:
% 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
$HOME/.mh_profile
The user profile.
/usr/lib/mh/mtstailor
The system customization file.
/usr/spool/mail/$USER
The user’s maildrop.
See Also
chmod(1), mhl(1mh), mhmail(1mh), scan(1mh), mh-mail(5mh), post(8mh)