Applied Kurt J. Lidl <lidl@eng.us.uu.net>'s $MAILHOST patch:

[mmh] / man / inc.man

diff --git a/man/inc.man b/man/inc.man
index b2e5c7b..4a06a7f 100644 (file)
--- a/man/inc.man
+++ b/man/inc.man
@@ -32,6 +32,9 @@ inc
 \%[\-user\ username]
 \%[\-pack\ file]
 \%[\-nopack]
+\%[\-kpop]
+\%[\-sasl]
+\%[\-saslmech\ mechanism]
 .br
 %nmhendpop%
 \%[\-version]
@@ -113,11 +116,12 @@ and going on to other things.
 %nmhbeginpop%
 
 .Uh "Using POP"
-\fIinc\fR will normally check local mail drops for mail, as given
-above.  But if the option \*(lqpophost:\*(rq is set in the mts
-configuration file \*(lqmts.conf\*(rq, or if the `\-host\ hostname'
-switch is given, then \fIinc\fR will query this POP service host
-for mail to incorporate.
+\fIinc\fR will normally check local mail drops for mail, as covered above.  But
+if the option \*(lqpophost:\*(rq is set in \*(lqmts.conf\*(rq, or if the
+`\-host\ hostname' switch is given, or if the \fB$MAILHOST\fR environment
+variable is set, then \fIinc\fR will query this POP service host for mail to
+incorporate.  If \fB$MAILHOST\fR is set and \-host is specified as well, the
+commandline switch will override the environment variable.
 
 The default is for \fIinc\fR to assume that your account name on
 the POP server is the same as your current username.  To specify
@@ -145,6 +149,22 @@ maildrops.
 For debugging purposes, you may give the switch `\-snoop', which will
 allow you to watch the POP transaction take place between you and the
 POP server.
+
+If nmh has been compiled with KPOP #defined, the `\-kpop' switch will allow
+\fIinc\fR to use Kerberized POP rather than standard POP3 on a given invocation.
+If POPSERVICE was also #defined to "kpop", \fIinc\fR will be hardwired to always
+use KPOP.
+
+If nmh has been compiled with SASL support, the `\-sasl' switch will enable
+the use of SASL authentication.  Depending on the SASL mechanism used, this
+may require an additional password prompt from the user (but the
+\*(lq.netrc\*(rq file can be used to store this password).  The
+`\-saslmech' switch can be used to select a particular SASL mechanism.
+
+If SASL authentication is successful, \fIinc\fR will attempt to negotiate
+a security layer for session encryption.  Encrypted traffic is labelled
+with `(encrypted)' and `(decrypted)' when viewing the POP transaction
+with the `\-snoop' switch.
 %nmhendpop%
 .Fi
 ^$HOME/\&.mh\(ruprofile~^The user profile