inc



INC(1)                                                                  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] [-host hostname]
            [-user username] [-pack file] [-nopack] [-kpop]
            [-version] [-help]


DESCRIPTION

       Inc  incorporates  mail  from the user's incoming mail drop into an nmh
       folder.

       You may specify which folder to use with `+folder'.  If  no  folder  is
       specified,  then  inc will use either the folder given by a (non-empty)
       "Inbox:" entry in the user's profile, or the folder named "inbox".   If
       the  specified  (or  default)  folder  doesn't  exist, the user will be
       queried prior to its creation.

       When the new messages  are  incorporated  into  the  folder,  they  are
       assigned  numbers starting with the next highest number for the folder.
       As the messages are processed, a scan listing of the new mail  is  pro-
       duced.

       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 nmh
       default  of  0644 will be used.  For all subsequent operations on these
       messages, this initially assigned protection will be preserved.

       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 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 nmh
       directory unless a full path is specified.

       Inc will incorporate even improperly formatted messages into the user's
       nmh 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 `-notrun-
       cate' 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.  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  environment variable $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 environ-
       ment 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 the user's nmh  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.


   Using POP
       inc will normally check local mail drops for mail, as given above.  But
       if  the  option  "pophost:"  is  set  in  the  mts  configuration  file
       "mts.conf", or if the `-host hostname' switch is given, then  inc  will
       query this POP service host for mail to incorporate.

       The  default  is  for  inc  to assume that your account name on the POP
       server is the same as your current username.  To  specify  a  different
       username, use the `-user username' switch.

       When  using  POP,  you will normally need to type the password for your
       account on the POP server, in order to retrieve your messages.   It  is
       possible  to automate this process by creating a ".netrc" file contain-
       ing your login account information for this POP server.  For  each  POP
       server,  this  file  should have a line of the following form.  Replace
       the words mypopserver, mylogin, and mypassword with  your  own  account
       information.

       machine mypopserver login mylogin password mypassword

       This ".netrc" file should be owned and readable only by you.

       If inc uses POP, then the `-pack file' switch is considered.  If given,
       then inc simply uses the POP to packf (1) the user's maildrop from  the
       POP  service host to the named file.  This switch is provided for those
       users who prefer to use msh to read their maildrops.

       For debugging purposes, you may give the switch  `-snoop',  which  will
       allow  you  to watch the POP transaction take place between you and the
       POP server.

       If nmh has been compiled with KPOP #defined, the  `-kpop'  switch  will
       allow  inc  to  use Kerberized POP rather than standard POP3 on a given
       invocation.  If POPSERVICE was also #defined to  "kpop",  inc  will  be
       hardwired to always use KPOP.


FILES

       $HOME/.mh_profile                    The user profile
       /etc/nmh/mts.conf                    nmh mts configuration file
       /var/mail/$USER                      Location of mail drop


PROFILE COMPONENTS

       Path:                To determine the user's nmh directory
       Alternate-Mailboxes: To determine the user's mailboxes
       Inbox:               To determine the inbox, default "inbox"
       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' defaulted by "Inbox" above
       `-noaudit'
       `-changecur'
       `-format' defaulted as described above
       `-nosilent'
       `-truncate' if `-file name' not given, `-notruncate' otherwise
       `-width' defaulted to the width of the terminal
       `-nopack'


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.



[nmh-1.0.4]                         MH.6.8                              INC(1)

Man(1) output converted with man2html