X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=man%2Finc.man;h=7a371cb8af5740c0315adc391ea93b2248d62b38;hb=ce2545144845a393150638904a4a27e94f62659d;hp=4a06a7f69a80eb21eaa04fc265df700977d3bd8f;hpb=7d5df1b80b43bfe60de33b0b62c992eea1d8d531;p=mmh

diff --git a/man/inc.man b/man/inc.man
index 4a06a7f..7a371cb 100644
--- a/man/inc.man
+++ b/man/inc.man
@@ -5,7 +5,7 @@
 .\" 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
@@ -32,9 +32,12 @@ inc
 \%[\-user\ username]
 \%[\-pack\ file]
 \%[\-nopack]
+\%[\-apop]
+\%[\-noapop]
 \%[\-kpop]
 \%[\-sasl]
 \%[\-saslmech\ mechanism]
+\%[\-snoop]
 .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.
 
+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