INC(1)                        [mh.6]                       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 starting 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 processed, 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
       messages, otherwise the MH default of 0644 will  be  used.
       During all operations on messages, this initially assigned
       protection 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 spec-
       ified 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  correspon-
       dence history.  Audit-file will be in the user's MH direc-
       tory 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.

       If  the  profile  entry  Unseen-Sequence  is  present  and



MH                        April 22, 1986                        1

INC(1)                        [mh.6]                       INC(1)


       non-empty,  then  inc  will add each of the newly incorpo-
       rated 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    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
       maildrop.  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/contrib/mh/lib/mtstailor         tailor file
       /var/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'
       `-truncate' if `-file name' not given, `-notruncate' otherwise
       `-width' defaulted to the width of the terminal




MH                        April 22, 1986                        2

INC(1)                        [mh.6]                       INC(1)


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.   There-
       fore,  one  must usually place the argument to this switch
       inside double-quotes.













































MH                        April 22, 1986                        3