diplodocus.org Git - nmh/blob - docs/historical/mh-jun-1982/man/inc.1

   1 .TH INC 1 RAND
   2 .SH NAME
   3 inc \- incorporate new mail
   4 .SH SYNOPSIS
   5 \fBinc\fR \%[+folder] \%[\fB\-audit\ \fRaudit-file] \%[\fB\-help\fR]
   6 \%[\fB\-changecur\fR] \%[\fB\-nochangecur\fR]
   7  \%[\-time] \%[\-notime] \%[\-numdate] \%[\-nonumdate]
   8 .SH DESCRIPTION
   9 \fIInc\fR incorporates mail from the user's incoming mail drop
  10 into an MH folder.
  11 If `+folder' isn't specified,
  12 the folder named ``inbox'' in the user's MH directory will be used.
  13 The
  14 new messages being incorporated are assigned numbers starting
  15 with the next highest number in the folder.
  16 If the specified (or
  17 default) folder doesn't exist, the user will be queried prior to
  18 its creation.
  19 As the messages are processed, a \fIscan\fR  listing
  20 of the new mail is produced.
  21
  22 If the user's profile contains a ``Msg\-Protect: nnn'' entry, it
  23 will be used as the protection on the newly created messages,
  24 otherwise the MH default of 664 will be used.
  25 During all
  26 operations on messages, this initially assigned protection will
  27 be preserved for each message, so \fIchmod\fR(I) may be used to set a
  28 protection on an individual message, and its protection will be
  29 preserved thereafter.
  30
  31 If the switch `\-audit audit-file' is specified (usually as a
  32 default switch in the profile), then \fIinc\fR will append a header
  33 line and a line per message to the end of the specified
  34 audit-file with the format:
  35
  36 .nf
  37 .ti 1i
  38 \*(<<inc\*(>> date
  39 .ti 1.5i
  40 <scan line for first message>
  41 .ti 1.5i
  42 <scan line for second message>
  43 .ti 2.5i
  44 <etc.>
  45 .fi
  46
  47 This is useful for keeping track of volume and source of incoming
  48 mail.
  49 Eventually, \fIrepl\fR, \fIforw\fR, \fIcomp\fR, and \fIdist\fR may also
  50 produce audits to this (or another) file, perhaps with
  51 ``Message-Id:'' information to keep an exact correspondence history.
  52 ``Audit-file'' will be in the user's MH directory unless a full
  53 path is specified.
  54
  55 \fIInc\fR will incorporate even illegally formatted messages into the
  56 user's MH folder, inserting a blank line prior to the offending
  57 component and printing a comment identifying the bad message.
  58
  59 In all cases, the \*.mail file will be zeroed.
  60
  61 If the `\-time' switch is selected, the time of the message is shown
  62 after the date in the scan lines.
  63 If the `\-numdate' switch is selected,
  64 the date (and time if `\-time' is selected) of the message
  65 is shown in the scan lines as one long number
  66 made up of year, month, day, hour, minute.
  67 .SH FILES
  68 .ta 2.4i
  69 $HOME/\*.mh\(ruprofile  The user profile
  70 .br
  71 /usr/spool/mail/*       The user's mail drop
  72 .br
  73 <mh-dir>/audit-file     Audit trace file (optional)
  74 .SH PROFILE COMPONENTS
  75 Path:   To determine the user's MH directory
  76 .br
  77 Folder\-Protect:        For protection on new folders
  78 .br
  79 Msg\-Protect:   For protection on new messages
  80 .SH SEE ALSO
  81 deliver(8), mh-mail(5), scan(1), mail(1)
  82 .SH DEFAULTS
  83 `+folder' defaults to ``inbox''
  84 .br
  85 `-changecur'
  86 .br
  87 `\-notime'
  88 .br
  89 `\-nonumdate'
  90 .SH CONTEXT
  91 The folder into which the message is
  92 being incorporated will become the
  93 current folder, and the first message incorporated will be the
  94 current message unless the
  95 .B \-nochangecur
  96 option is specified.
  97 This leaves the context ready for a \fIshow\fR
  98 of the first new message.
  99 .SH BUGS
 100 The `\-numdate' option ignores tim