X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=man%2Fwhom.man;h=49942707ebc23e2343329ea4354d5cd4f9909c20;hb=7fd676d57355fd26c1127a79d9ba805973928316;hp=2ef3e1a76d467de3127b4792517d1ef732a9a2f8;hpb=e1b3eb2cfcc2823fb2bb429aa54d9d6c296fc16b;p=mmh

diff --git a/man/whom.man b/man/whom.man
index 2ef3e1a..4994270 100644
--- a/man/whom.man
+++ b/man/whom.man
@@ -1,25 +1,40 @@
+.TH WHOM %manext1% "July 11, 2012" "%nmhversion%"
 .\"
 .\" %nmhwarning%
-.\" $Id$
 .\"
-.TH WHOM %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 whom \- report to whom a message would go
 .SH SYNOPSIS
 .HP 5
+.na
 .B whom
 .RB [ \-alias
 .IR aliasfile ]
 .RB [ \-check " | " \-nocheck ]
-.RB [ \-draft ]
 .RB [ \-draftfolder
 .IR +folder ]
 .RB [ \-draftmessage
 .IR msg ]
 .RB [ \-nodraftfolder ]
+.RB [ \-mts
+.IR smtp " | " sendmail/smtp " | " sendmail/pipe ]
+.RB [ \-server
+.IR servername ]
+.RB [ \-port
+.IR port-name/number ]
+.RB [ \-sasl ]
+.RB [ \-saslmech
+.IR mechanism ]
+.RB [ \-snoop ]
+.RB [ \-user
+.IR username ]
+.RB [ \-tls ]
+.RB [ \-notls ]
 .RI [ file ]
+.RB [ \-draft ]
 .RB [ \-version ]
 .RB [ \-help ]
+.ad
 .SH DESCRIPTION
 .B Whom
 is used to expand the headers of a message into a set of
@@ -39,9 +54,69 @@ the
 .B nmh
 draft folder facility.  This is an advanced (and highly
 useful) feature.  Consult the
-.BR mh-draft (5)
+.IR mh-draft (5)
 man page for more information.
 .PP
+The mail transport system default is provided in
+.I %etcdir%/mts.conf
+but can be overriiden here with the
+.B \-mts
+switch.
+.PP
+If nmh is using the SMTP MTA, the
+.B \-server
+and the
+.B \-port
+switches can be used to override the default mail server (defined by the
+.I %etcdir%/mts.conf
+.RI servers
+entry).  The
+.B \-snoop
+switch can be used to view the SMTP transaction.  (Beware that the
+SMTP transaction may contain authentication information either in
+plaintext or easily decoded base64.)
+.PP
+If
+.B nmh
+has been compiled with SASL support, the
+.B \-sasl
+switch will enable
+the use of SASL authentication with the SMTP MTA.  Depending on the
+SASL mechanism used, this may require an additional password prompt from the
+user (but the
+.RI \*(lq \&.netrc \*(rq
+file can be used to store this password).
+.B \-saslmech
+switch can be used to select a particular SASL mechanism,
+and the the
+.B \-user
+switch can be used to select a authorization userid
+to provide to SASL other than the default.
+.PP
+If SASL authentication is successful, 
+.BR nmh
+will attempt to negotiate a security layer for session encryption.
+Encrypted data is labelled with `(encrypted)' and `(decrypted)' when
+viewing the SMTP transaction with the
+.B \-snoop
+switch.  The
+.B \-saslmaxssf
+switch can be used to select the maximum value of the Security Strength Factor.
+This is an integer value and the exact meaning of this value depends on the
+underlying SASL mechanism.  A value of 0 disables encryption.
+.PP
+If
+.B nmh
+has been compiled with TLS support, the
+.B \-tls
+and
+.B \-notls
+switches will require and disable the negotiation of TLS support when connecting to the
+SMTP MTA.  Encrypted data is labelled with `(tls-encrypted)' and
+`(tls-decrypted)' when viewing the SMTP transction with the
+.B \-snoop
+switch.
+.PP
 The files specified by the profile entry \*(lqAliasfile:\*(rq and any
 additional alias files given by the
 .B \-alias
@@ -50,16 +125,14 @@ switch will be
 read (more than one file, each preceded by
 .BR \-alias ,
 can be named). See
-.BR mh\-alias (5)
+.IR mh\-alias (5)
 for more information.
-
 .SH FILES
 .fc ^ ~
 .nf
-.ta \w'/usr/local/nmh/etc/ExtraBigFileName  'u
+.ta \w'%etcdir%/ExtraBigFileName  'u
 ^$HOME/\&.mh\(ruprofile~^The user profile
 .fi
-
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf
@@ -70,20 +143,17 @@ for more information.
 ^Aliasfile:~^For a default alias file
 ^postproc:~^Program to post the message
 .fi
-
 .SH "SEE ALSO"
-mh\-alias(5), post(8)
-
+.IR mh\-alias (5),
+.IR post (8)
 .SH DEFAULTS
 .nf
 .RB ` file "' defaults to <mh\-dir>/draft"
 .RB ` \-nocheck '
 .RB ` \-alias "' defaults to  %etcdir%/MailAliases"
 .fi
-
 .SH CONTEXT
 None
-
 .SH BUGS
 With the
 .B \-check