INC(1)		      [mh.6] (MH.6.8)			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, a folder
	  in the user's	MH directory will be used, either that
	  specified by the Inbox: entry	in the user's profile, or the
	  folder named inbox.  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
	  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 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

     Page 1					     (printed 9/30/94)

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

	  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 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/local/lib/mh/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
	  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'

     Page 2					     (printed 9/30/94)

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

	  `-format' defaulted as described above
	  `-nosilent'
	  `-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.

     Page 3					     (printed 9/30/94)