Updating comp-forw

[mmh] / man / msgchk.man

diff --git a/man/msgchk.man b/man/msgchk.man
index 2f1fed5..4c8a53a 100644 (file)
--- a/man/msgchk.man
+++ b/man/msgchk.man
@@ -5,7 +5,7 @@
 .\" include the -mh macro file
 .so %etcdir%/tmac.h
 .\"
 .\" 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
 .SH NAME
 msgchk \- check for messages
 .SH SYNOPSIS

@@ -20,9 +20,12 @@ msgchk
 %nmhbeginpop%
 \%[\-host\ hostname]
 \%[\-user\ username]
 %nmhbeginpop%
 \%[\-host\ hostname]
 \%[\-user\ username]

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

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

+\%[\-snoop]

 .br
 %nmhendpop%
 \%[users\ ...]
 .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.
 
 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
 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