*** UNIX MANUAL PAGE BROWSER ***

inc(1) General Commands Manual inc(1) NAME inc - Incorporates new mail (only available within the message handling system, mh) SYNOPSIS inc [ +folder ] [ flags ] FLAGS The -audit flag specifies that a record be kept in the named file of all new mail that is incorporated. The inc command places a scan line in the named audit file for each message it incorporates. This is use- ful for keeping track of the volume and source of incoming mail. Auditing is often set up in the .mh_profile file rather than through the -audit flag on the command line. See the mh_pro- file(4) reference page for more information on how to add en- tries to .mh_profile. If auditing is enabled through the .mh_profile file, you can disable it by using the -noaudit flag on the command line. The -changecur flag makes the first new message the current message. This is the default operation of inc. If you want the current message to remain as it was, use the -nochangecur flag. The -conv flag converts the mail exchange codeset of the incoming message to the user application codeset at the time an incoming message is stored. By default, conversion to user application code is done when mail is displayed. If the incoming message contains a Content-Type header with a charset value, the inc -conv command modifies this value to be the name of the applica- tion codeset. The command uses the value in the /usr/lib/mail- codesets file as the mail interchange codeset. If this file is absent or if the appropriate converter is not installed in the /usr/lib/nls/loc/iconv directory, codeset conversion does not occur. If the /usr/lib/mail-codesets file specifies a value that does not match the mail interchange codeset of the incoming message, the conversion operation may corrupt the contents of the message. Refer to mh(1) for more information about the /usr/lib/mail-codesets file. You can specify the inshdr parameter with the -conv flag if you receive many messages without the "Content-Type" header entry and you need to include it at the time the message is converted and stored. The header consists of the following lines: Mime-Version: 1.0 Content-Type: TEXT/PLAIN; charset="<applica- tion-codeset>" The -noconv flag, which is the default, specifies that the ex- change codeset of the incoming message is not converted to the user application codeset at the time a message is stored. In- corporates mail from a named file. This is usually a file other than your default maildrop. Note that the mail system does not zero the named file unless the -truncate flag is given. Con- trols the format of the display produced by the inc command. The output of inc is formatted according to the instructions in the named file. The file must be an mhl format file; see the mh-format(4) reference for more information. Controls the for- mat of the display produced by the inc command. The output of inc is formatted according to the instructions given by the specified string. This must be a standard format string; see the mh-format(4) reference page for more information. If the string contains blank spaces, the whole string must be enclosed in double quotes. Prints a list of the valid flags for this command. The -silent flag directs inc to be quiet and not ask any questions at all. The -silent flag is useful when you want to run inc in the background and go on to other tasks. By de- fault, the -nosilent flag is in effect. Specifies the source file from which mail is retrieved. The only value allowed is the keyword file, which specifies the standard mail system. Al- ternative values are supported only for use with other mail sys- tems. The -truncate flag zeroes your maildrop file when mail is fetched from it. This is the default operation for /usr/spool/mail/$USER but not for an alternative maildrop speci- fied by the -file flag. Specify the -notruncate flag if you do not want the /usr/spool/mail/$USER file to be zeroed. Specify the -truncate flag if you do want the file specified with the -file flag to be zeroed. Controls the width of the display produced by inc. By default, or if no value is specified, the inc command produces a display as wide as the terminal screen allows. PARAMETERS Specifies the folder into which new mail is incorporated. By default, the inc command incorporates mail into your +inbox folder. DESCRIPTION Use the inc command to incorporate mail from your incoming maildrop into a folder. 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, inc will ask you whether you want to create it. As the messages are processed, the command produces a scan listing of the new mail messages. See the scan(1) reference page for details of the listing produced. The folder into which messages are being incorporated becomes the cur- rent folder. If your .mh_profile contains a Msg-Protect: entry, the mail system uses this entry as the protection on the newly created messages; otherwise, it uses the protection 0600. When the 0600 default protection is used, it means that messages created have read and write permission for the user only. During all operations on messages, the mail system pre- serves this initially assigned protection for each message. You can also use the chmod command to set a different protection on an individ- ual message; in this case, the mail system preserves the new protec- tion. Note that the inc command incorporates improperly formatted messages into your folder, inserting a blank line prior to the offending compo- nent and printing a comment identifying the bad message. If the entry Unseen-Sequence is present in your profile, then inc adds 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 the MH commands that take the msg or msgs arguments. Note that inc does not zero each sequence prior to adding messages. If the environment variable $MAILDROP is set, then inc uses the value of this variable as the location of your maildrop instead of the de- fault. If this variable is not set, then inc consults the profile en- try Maildrop for this information. If the value found is not absolute, then it is interpreted relative to your Mail directory, which is usu- ally $HOME/Mail. If the value is not found, then inc looks in the stan- dard system location for your maildrop. The -file flag overrides all these defaults. If you specify no parameters or flags on the inc command line, the fol- lowing defaults are in effect: +folder defaults to +inbox -noaudit -changecur -nosilent -truncate if the -file flag is not given; other- wise, -notruncate -width defaults to the width of the terminal -noconv Profile Components The following entries in the $HOME/.mh_profile file affect inc command operation: To determine your Mail directory. To determine your mail- boxes. To set protection mode when creating a new folder. To deter- mine the location of your maildrop. To set protection mode when creat- ing a new message or an audit file. To name sequences denoting unseen messages. RESTRICTIONS For this version of MH, the -source flag supports only 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 +not_read: % inc +not_read FILES The user profile The system customization file The user's maildrop RELATED INFORMATION Commands: chmod(1), mhl(1), mhmail(1), scan(1), post(8) Files: mh-mail(4), mh-format(4), mh_profile(4) delim off inc(1)