ultrix man page for inc

inc(1mh)																  inc(1mh)

Name
       inc - incorporate new mail

Syntax
       inc [ +folder ] [ options ]

Description
       Use to incorporate mail from your incoming maildrop into a folder.

       Normally,  incorporates new mail into your folder.  If you supply a +folder argument, mail is incorporated into the named folder instead of
       your

       The new messages being incorporated are numbered sequentially starting with the next highest available number in the folder.  If the speci-
       fied  (or  default) folder does not exist, will ask you whether you want to create it.  As the messages are processed, a listing of the new
       mail is produced.  See for details of the listing produced.

       The folder into which messages are being incorporated will become the current folder.

       If your contains a Msg-Protect: entry, the mail system will use this as the protection on the newly created messages;  otherwise,  it  will
       use the default of 0600.  This means that messages created will have read and write permission for the user only.  During all operations on
       messages, the mail system will preserve this initially assigned protection for each message.  You can also use to set a	different  protec-
       tion on an individual message; in this case the mail system will preserve the new protection.

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

       If the entry Unseen-Sequence is present in your profile, then will add each of the newly incorporated messages to each  sequence  named	by
       the  profile entry.  This is similar to the Previous-Sequence (R)profile entry supported by all MH commands which take msg (R)or msgs argu-
       ments.  Note that will not zero each sequence prior to adding messages.

       If the environment variable $MAILDROP is set, then uses it as the location of your maildrop instead of the default.  If	this  variable	is
       not  set, then will consult the profile entry Maildrop (R)for this information.	If the value found is not absolute, then it is interpreted
       relative to your Mail directory, which is usually If the value is not found, then (R)will look in the standard  system  location  for  your
       maildrop.  The -file (R)option will override all of these.

Options
       -audit audit-file
       -noaudit  Keeps a record of all new mail that is incorporated.  The places a line in the named audit file for each message it incorporates.
		 This is useful for keeping track of the volume and source of incoming mail.

		 This option is often set up in the file.  See for more information on how to add entries to the file.	If this option is added to
		 the it can be overridden using the -noaudit option at the command line.

       -changecur
       -nochangecur
		 Makes	the  first new message the current message.  This is the default operation of If you want the current message to remain as
		 it was, use the -nochangecur option.

       -file name
		 Incorporates mail from a named file.  This is usually a file other than your maildrop.  Note that the mail system will  not  zero
		 the named file unless the -truncate switch is given.

       -form formatfile
		 Controls  the	format	of the display produced.  The output of is formatted according to the instructions in the named file.  The
		 file must be an mhl format file; see for more information.

       -format string
		 Controls the format of the display produced.  The output of is formatted according to the instructions given by the  string  sup-
		 plied.   This	must be a standard format string; see for more information.  If the string contains blank spaces, the whole string
		 must be enclosed in double quotes.

       -help	 Prints list of the valid options for this command.

       -silent
       -nosilent Directs to be quiet and not ask any questions at all.	This is useful for putting in the background and going on to other things.

       -source file
		 Specifies the source from which mail is retrieved.  The only value allowed is file, which is the  standard  ULTRIX  mail  system.
		 Additional values are supported only for use with other mail systems.

       -truncate
       -notruncate
		 Zeroes your maildrop file when mail is fetched from it.  This is the default operation; your mail drop will be zeroed, unless the
		 -notruncate option is given.

       -width	 Controls the width of the display produced by The default is the width of the terminal; if no value is given, prints its  display
		 as wide as the screen allows.

       The defaults for this command are:

	      defaults to
	      -noaudit
	      -changecur
	      -nosilent
	      -truncate if the -file option is not given, -notruncate otherwise
	      -width defaults to the width of the terminal

Restrictions
       For this version of MH, the -source option only supports the value file.  Additional values are supported for use only with other mail sys-
       tems.

Examples
       The following example fetches incoming mail and places it in the folder
       % inc +not_read

Profile Components
       Path:		      To determine your Mail directory
       Alternate-Mailboxes:   To determine your mailboxes
       Folder-Protect:	      To set mode when creating a new folder
       Maildrop:	      To determine the location of your maildrop
       Msg-Protect:	      To set mode when creating a new message
			      and audit-file
       Unseen-Sequence:       To name sequences denoting unseen messages

Files
       The user profile.

       The system customization file.

       The user's maildrop.

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

																	  inc(1mh)