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 specified
       (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 mes‐
       sages, the mail system will preserve this initially assigned protection
       for each message.  You can also use to set a different protection 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 ®profile entry
       supported by all MH commands which take msg ®or msgs  arguments.	  Note
       that will not zero each sequence prior to adding messages.

       If the environment variable $MAILDROP is set, then uses it as the loca‐
       tion of your maildrop instead of the default.  If this variable is  not
       set,  then  will	 consult the profile entry Maildrop ®for this informa‐
       tion.  If the value found is not absolute, then it is interpreted rela‐
       tive  to	 your  Mail  directory,	 which	is usually If the value is not
       found, then ®will look in the standard system location for  your	 mail‐
       drop.  The -file ®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 infor‐
		 mation	 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 informa‐
		 tion.

       -format string
		 Controls the format of the display produced.  The  output  of
		 is  formatted	according  to  the  instructions  given by the
		 string supplied.  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 sys‐
		 tem.  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 other‐
	      wise
	      -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
       systems.

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)

Vote for polarhome