Updating comp-forw

[mmh] / man / inc.man

diff --git a/man/inc.man b/man/inc.man
index 4a06a7f..7a371cb 100644 (file)
--- a/man/inc.man
+++ b/man/inc.man
@@ -5,7 +5,7 @@
 .\" include the -mh macro file
 .so %etcdir%/tmac.h
 .\"
 .\" include the -mh macro file
 .so %etcdir%/tmac.h
 .\"

-.TH INC %manext1% MH.6.8 [%nmhversion%]
+.TH INC %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]

 .SH NAME
 inc \- incorporate new mail
 .SH SYNOPSIS
 .SH NAME
 inc \- incorporate new mail
 .SH SYNOPSIS

@@ -32,9 +32,12 @@ inc
 \%[\-user\ username]
 \%[\-pack\ file]
 \%[\-nopack]
 \%[\-user\ username]
 \%[\-pack\ file]
 \%[\-nopack]

+\%[\-apop]
+\%[\-noapop]

 \%[\-kpop]
 \%[\-sasl]
 \%[\-saslmech\ mechanism]
 \%[\-kpop]
 \%[\-sasl]
 \%[\-saslmech\ mechanism]

+\%[\-snoop]

 .br
 %nmhendpop%
 \%[\-version]
 .br
 %nmhendpop%
 \%[\-version]

@@ -150,6 +153,17 @@ 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.
 
 allow you to watch the POP transaction take place between you and the
 POP server.
 

+If nmh has been compiled with APOP #defined, the `\-apop' switch will cause
+\fIinc\fR to use APOP rather than standard POP3 authentication.  Under APOP, a
+unique string (generally of the format
+<\fIpid\fR.\fItimestamp\fR@\fIhostname\fR>) is announced by the POP server.
+Rather than `USER \fIuser\fR', `PASS \fIpassword\fR', inc sends `APOP \fIuser\fR
+\fIdigest\fR', 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).  `\-noapop' disables APOP in cases where it'd
+otherwise be used.
+

 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
 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