X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=man%2Finc.man;h=4c471fcb98a13ce0cf63380117aa218e8b6a0d27;hb=5e5e8b753acc7ff1e16c7fca172a2151a6c01353;hp=baaead8e96ce9fe198acadbefa4b094e956368a0;hpb=99e5043db7ee6cf80f93708610a6e584a8068c6a;p=mmh diff --git a/man/inc.man b/man/inc.man index baaead8..4c471fc 100644 --- a/man/inc.man +++ b/man/inc.man @@ -1,8 +1,7 @@ +.TH INC %manext1% "November 6, 2012" "%nmhversion%" .\" .\" %nmhwarning% -.\" $Id$ .\" -.TH INC %manext1% "%nmhdate%" MH.6.8 [%nmhversion%] .SH NAME inc \- incorporate new mail .SH SYNOPSIS @@ -24,7 +23,6 @@ inc \- incorporate new mail .RB [ \-truncate " | " \-notruncate ] .RB [ \-width .IR columns ] -%nmhbeginpop% .RB [ \-host .IR hostname ] .RB [ \-user @@ -34,13 +32,10 @@ inc \- incorporate new mail .RB [ \-nopack ] .RB [ \-proxy .IR command ] -.RB [ \-apop " | " \-noapop ] -.RB [ \-kpop ] .RB [ \-sasl ] .RB [ \-saslmech .IR mechanism ] .RB [ \-snoop ] -%nmhendpop% .RB [ \-version ] .RB [ \-help ] .ad @@ -50,6 +45,14 @@ incorporates mail from the user's incoming mail drop into an .B nmh folder. +If the mail drop is a file, it can be in +.B mbox +or +.B MMDF +format. +If the mail drop is a directory it will considered to be a +.B Maildir +format mail drop. .PP You may specify which folder to use with .IR +folder . @@ -70,12 +73,12 @@ 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 +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. +default of 0600 will be used (on filesystems that support it). For +all subsequent operations on these messages, this initially assigned +protection will be preserved. .PP If the switch .B \-audit @@ -88,7 +91,7 @@ line per message to the end of the specified audit\-file with the format: .PP .RS 5 .nf -\*(<> date +<> date @@ -175,7 +178,6 @@ switch directs 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. -%nmhbeginpop% .PP .SS "Using POP" .B inc @@ -264,42 +266,6 @@ between you and the POP server. .PP If .B nmh -has been compiled with APOP support, the -.B \-apop -switch will cause -.B inc -to use APOP rather than standard POP3 authentication. Under APOP, a -unique string (generally of the format -.RI < pid . timestamp @ hostname > -) is announced by the POP server. -Rather than `USER -.IR user ', -`PASS -.IR password ', -.B inc -sends `APOP -.I user -.IR digest ', -where digest is the MD5 hash of the unique string followed by a -`secret' shared by client and server, essentially equivalent to the user's -password (though an APOP-enabled POP3 server could have separate APOP and plain -POP3 passwords for a single user). -.B \-noapop -disables APOP in cases where it'd otherwise be used. -.PP -If -.B nmh -has been compiled with KPOP support, the -.B \-kpop -switch will allow -.B inc -to use Kerberized POP rather than standard POP3 on a given invocation. -If POPSERVICE was also #defined to "kpop", -.B inc -will be hardwired to always use KPOP. -.PP -If -.B nmh has been compiled with SASL support, the .B \-sasl switch will enable @@ -317,8 +283,6 @@ Encrypted traffic is labelled with `(encrypted)' and `(decrypted)' when viewing the POP transaction with the .B \-snoop switch. -%nmhendpop% - .SH FILES .fc ^ ~ .nf @@ -327,7 +291,6 @@ switch. ^%etcdir%/mts.conf~^nmh mts configuration file ^%mailspool%/$USER~^Location of mail drop .fi - .SH "PROFILE COMPONENTS" .fc ^ ~ .nf @@ -340,10 +303,11 @@ switch. ^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) - +.IR mhmail (1), +.IR scan (1), +.IR mh\-mail (5), +.IR post (8) .SH DEFAULTS .nf .RB ` +folder "' defaulted by \*(lqInbox\*(rq above" @@ -353,11 +317,8 @@ mhmail(1), scan(1), mh\-mail(5), post(8) .RB ` \-nosilent ' .RB ` \-truncate "' if `" \-file " name' not given, `" \-notruncate "' otherwise" .RB ` \-width "' defaulted to the width of the terminal" -%nmhbeginpop% .RB ` \-nopack ' -%nmhendpop% .fi - .SH CONTEXT The folder into which messages are being incorporated will become the current folder. The first message incorporated will become the current @@ -366,12 +327,3 @@ message, unless the 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.