X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fmsgchk.man;h=4c8a53abcbf5a13605e017ea28566d7812485f5d;hp=2f1fed5bba5b8237dde6bda9e77a3ab4b38786e5;hb=9892129b33a8da3329f6331078a94a18ff8fe0e2;hpb=cfc525a9b85207225cb4071d1d3b01e8d1db2424

diff --git a/man/msgchk.man b/man/msgchk.man
index 2f1fed5..4c8a53a 100644
--- a/man/msgchk.man
+++ b/man/msgchk.man
@@ -5,7 +5,7 @@
 .\" include the -mh macro file
 .so %etcdir%/tmac.h
 .\"
-.TH MSGCHK %manext1% MH.6.8 [%nmhversion%]
+.TH MSGCHK %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 msgchk \- check for messages
 .SH SYNOPSIS
@@ -20,9 +20,12 @@ msgchk
 %nmhbeginpop%
 \%[\-host\ hostname]
 \%[\-user\ username]
+\%[\-apop]
+\%[\-noapop]
 \%[\-kpop]
 \%[\-sasl]
 \%[\-saslmech \mechanism]
+\%[\-snoop]
 .br
 %nmhendpop%
 \%[users\ ...]
@@ -79,6 +82,17 @@ For debugging purposes, there is also a 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
+\fImsgchk\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', msgchk 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
 \fImsgchk\fR to use Kerberized POP rather than standard POP3 on a given
 invocation.  If POPSERVICE was also #defined to "kpop", \fImsgchk\fR will be