X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Finc.man;fp=man%2Finc.man;h=0000000000000000000000000000000000000000;hp=1dc958909980c52e0f2d035654e4ba1ab2e94f95;hb=5aaedc4256d58afe2481d667afdcb5162a914ba9;hpb=2676fdf95667cfa0fec45372dbb956c8645c1119 diff --git a/man/inc.man b/man/inc.man deleted file mode 100644 index 1dc9589..0000000 --- a/man/inc.man +++ /dev/null @@ -1,213 +0,0 @@ -.\" -.\" %nmhwarning% -.\" -.TH INC %manext1% "%nmhdate%" MH.6.8 [%nmhversion%] -.SH NAME -inc \- incorporate new mail -.SH SYNOPSIS -.HP 5 -.na -.B inc -.RI [ +folder ] -.RB [ \-audit -.IR audit\-file ] -.RB [ \-noaudit ] -.RB [ \-changecur " | " \-nochangecur ] -.RB [ \-form -.IR formfile ] -.RB [ \-format -.IR string ] -.RB [ \-file -.IR name ] -.RB [ \-silent " | " \-nosilent ] -.RB [ \-truncate " | " \-notruncate ] -.RB [ \-width -.IR columns ] -.RB [ \-version ] -.RB [ \-help ] -.ad -.SH DESCRIPTION -.B Inc -incorporates mail from the user's incoming mail drop into -an -.B nmh -folder. -.PP -You may specify which folder to use with -.IR +folder . -If no folder is specified, then -.B inc -will use either the folder given by a (non\-empty) -.RI \*(lq Inbox \*(rq -entry in the user's profile, or the folder named -.RI \*(lq inbox \*(rq. -If the specified (or default) folder doesn't -exist, the user will be queried prior to its creation. -.PP -When the new messages are incorporated into the folder, they are assigned -numbers starting with the next highest number for the folder. As the -messages are processed, a -.B scan -listing of the new mail is produced. -.PP -If the user's profile contains a -.RI \*(lq "Msg\-Protect: nnn" \*(rq -entry, it -will be used as the protection on the newly created messages, otherwise -the -.B nmh -default of 0644 will be used. For all subsequent operations -on these messages, this initially assigned protection will be preserved. -.PP -If the switch -.B \-audit -.I audit\-file -is specified (usually as a default -switch in the profile), then -.B inc -will append a header line and a -line per message to the end of the specified audit\-file with the format: -.PP -.RS 5 -.nf -<> date - - - -.fi -.RE -.PP -This is useful for keeping track of volume and source of incoming mail. -Eventually, -.BR repl , -.BR forw , -.BR comp , -and -.B dist -may also produce audits to this (or another) file, perhaps with -.RI \*(lq Message\-Id \*(rq -information to keep an exact correspondence -history. -.RI \*(lq Audit\-file \*(rq -will be in the current directory unless a full path is specified. -.PP -.B Inc -will incorporate even improperly formatted messages into the -user's nmh folder, inserting a blank line prior to the offending component -and printing a comment identifying the bad message. -.PP -In all cases, the user's mail drop will be zeroed, unless the -.B \-notruncate -switch is given. -.PP -If the profile entry -.RI \*(lq Unseen\-Sequence \*(rq -is present and non\-empty, then -.B inc -will add each of the newly incorporated messages to -each sequence named by the profile entry. -.B Inc -will not zero each sequence prior to adding messages. -.PP -The interpretation of the -.B \-form -.IR formatfile , -.B \-format -.IR string , -and -.B \-width -.I columns -switches is the same as in -.BR scan . -.PP -By using the -.B \-file -.I name -switch, one can direct -.B inc -to incorporate messages from a file other than the user's maildrop. -Note that the name file will NOT be zeroed, unless the -.B \-truncate -switch is given. -.PP -If the environment variable -.B $MAILDROP -is set, then -.B inc -uses it as the location of the user's maildrop instead of the default -(the -.B -file -.I name -switch still overrides this, however). If this -environment variable is not set, then -.B inc -will consult the profile entry -.RI \*(lq MailDrop \*(rq -for this information. If the value found is -not absolute, then it is interpreted relative to the user's -.B nmh -directory. If the value is not found, then -.B inc -will look in the standard system location for the user's maildrop. -.PP -The -.B \-silent -switch directs -.B inc -to be quiet and not ask any questions at all. This is useful for putting -.B inc -in the background and going on to other things. - -.SH FILES -.fc ^ ~ -.nf -.ta \w'%etcdir%/ExtraBigFileName 'u -^$HOME/.mmh/profile~^The user profile -^%etcdir%/mts.conf~^nmh mts configuration file -^%mailspool%/$USER~^Location of mail drop -.fi - -.SH "PROFILE COMPONENTS" -.fc ^ ~ -.nf -.ta 2.4i -.ta \w'ExtraBigProfileName 'u -^Path:~^To determine the user's mail storage -^Alternate\-Mailboxes:~^To determine the user's mailboxes -^Inbox:~^To determine the inbox, default \*(lqinbox\*(rq -^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 -.fi - -.SH "SEE ALSO" -mhmail(1), scan(1), mh\-mail(5), post(8) - -.SH DEFAULTS -.nf -.RB ` +folder "' defaulted by \*(lqInbox\*(rq above" -.RB ` \-noaudit ' -.RB ` \-changecur ' -.RB ` \-format "' defaulted as described above" -.RB ` \-nosilent ' -.RB ` \-truncate "' if `" \-file " name' not given, `" \-notruncate "' otherwise" -.RB ` \-width "' defaulted to the width of the terminal" -.fi - -.SH 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 -.B \-nochangecur -option is specified. This leaves the context ready for a -.B show -of the first new message. - -.SH BUGS -The argument to the -.B \-format -switch must be interpreted as a single -token by the shell that invokes -.BR inc . -Therefore, one must usually place the argument to this switch inside -double\-quotes.