INC(1)              RISC/os Reference Manual               INC(1)



NAME
     inc - incorporate new mail

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

DESCRIPTION
     Inc incorporates mail from the user's incoming mail drop
     into an MH folder.  If `+folder' isn't specified, the folder
     named "inbox" in the user's MH directory will be used.  The
     new messages being incorporated are assigned numbers start-
     ing with the next highest number in the folder.  If the
     specified (or default) folder doesn't exist, the user will
     be queried prior to its creation.  As the messages are pro-
     cessed, a scan listing of the new mail is produced.

     If the user's profile contains a "Msg-Protect: nnn" entry,
     it will be used as the protection on the newly created mes-
     sages, otherwise the MH default of 0644 will be used.  Dur-
     ing all operations on messages, this initially assigned pro-
     tection will be preserved for each message, so chmod(1) may
     be used to set a protection on an individual message, and
     its protection will be preserved thereafter.

     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 speci-
     fied 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 volume and source of
     incoming mail.  Eventually, repl, forw, comp, and dist may
     also produce audits to this (or another) file, perhaps with
     "Message-Id:" information to keep an exact correspondence
     history.  "Audit-file" will be in the user's MH directory
     unless a full path is specified.

     Inc will incorporate even improperly formatted messages into
     the user's MH folder, inserting a blank line prior to the
     offending component and printing a comment identifying the
     bad message.

     In all cases, the user's mail drop will be zeroed, unless
     the `-notruncate' switch is given.




                        Printed 11/19/92                MH Page 1

INC(1)              RISC/os Reference Manual               INC(1)



     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 sup-
     ported by all MH commands which take `msgs' or `msg' argu-
     ments.  Note that inc will not zero each sequence prior to
     adding messages.

     The interpretation of the `-form formatfile',
     `-format string', and `-width columns' switches is the same
     as in scan (1).

     By using the `-file name' switch, one can direct inc to
     incorporate messages from a file other than the user's mail-
     drop.  Note that the name file will NOT be zeroed, unless
     the `-truncate' switch is given.

     If the envariable $MAILDROP is set, then inc uses it as the
     location of the user's maildrop instead of the default (the
     `-file name' switch still overrides this, however).  If this
     envariable 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 the
     user's MH directory.  If the value is not found, then inc
     will look in the standard system location for the user's
     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.

FILES
     $HOME/.mh_profile                 The user profile
     /usr/new/lib/mh/mtstailor         tailor file
     /usr/mail/$USER                   Location of mail drop

PROFILE COMPONENTS
     Path:                To determine the user's MH directory
     Alternate-Mailboxes: To determine the user's mailboxes
     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

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

DEFAULTS
     `+folder' defaults to "inbox"
     `-noaudit'
     `-changecur'
     `-format' defaulted as described above
     `-nosilent'



MH Page 2               Printed 11/19/92

INC(1)              RISC/os Reference Manual               INC(1)



     `-truncate' if `-file name' not given, `-notruncate' otherwise
     `-width' defaulted to the width of the terminal

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 `-nochangecur'
     option is specified.  This leaves the context ready for a
     show of the first new message.

BUGS
     The argument to the `-format' switch must be interpreted as
     a single token by the shell that invokes inc.  Therefore,
     one must usually place the argument to this switch inside
     double-quotes.








































                        Printed 11/19/92                MH Page 3