NAME

inc − incorporate new mail

SYNTAX

inc [+foldername] [−audit audit−file] [−noaudit] [−changecur] [−nochangecur] [−form formatfile] [−format string] [−file name] [−silent] [−nosilent] [−truncate] [−notruncate] [−width columns] [−help]

DESCRIPTION

Use inc to incorporate mail from your incoming mail drop into an MH folder. If +folder is not specified, the folder named +inbox in your MH directory will be used.

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.

If your mh_profile contains a Msg−Protect: nnn entry, it will be used as the protection on the newly created messages, otherwise the MH default of 0600 will be used.  This means that messages created will be read and write for the user only. During all operations on messages, this initially assigned protection will be preserved for each message, so chmod may be used to set a protection on an individual message, and its protection will be preserved thereafter.

OPTIONS

If the switch −audit audit-file is specified (usually as a default switch in the profile), then inc will append a header line and a line per message to the end of the specified audit-file with the format:

inc date

<scan line for first message>

<scan line for second message>

<etc.>

This is useful for keeping track of the volume and source of incoming mail. 

Note that inc will incorporate even improperly formatted messages into your MH folder, inserting a blank line prior to the offending component and printing a comment identifying the bad message.

In all cases, your mail drop will be zeroed, unless the −notruncate switch is given.

If the profile entry Unseen−Sequence is present and non−empty, 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 <msgs> or <msg> arguments.  Note that inc will not zero each sequence prior to adding messages.

The −form  formatfile, and the −format  string, and −width  columns switches allow you to override the default output format of inc. See scan() for more details of these options.

By using the −file  name switch, you can direct inc to incorporate messages from a file other than your maildrop. Note that the named file will not be zeroed, unless the −truncate switch is given.

If the environment variable $MAILDROP is set, then inc uses it as the location of your maildrop instead of the default.  However the −file  filename switch overrides this.  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 MH directory. If the value is not found, then inc will look in the standard system location for your maildrop.

The −silent switch directs 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.

The argument to the −format switch must be interpreted as a single token by the shell that invokes inc. Therefore, you should usually place the argument to this switch inside double−quotes.

The defaults for this command are:

+folder defaults to inbox
−noaudit
−changecur
−format defaults as described above
−nosilent
−truncate if −file name not given, −notruncate otherwise
−width defaulted to the width of the terminal

The folder into which messages are being incorporated will become the current folder.  The first message incorporated will become the current message, unless the −nochangecur option is specified. This leaves the context ready for a show of the first new message.

FILES

PROFILE COMPONENTS

SEE ALSO

chmod(1mh), mhmail(1mh), scan(1mh), mh-mail(5mh), post(8mh)

Commands