new.c: Order two return statements to match comment.

[nmh] / man / whom.man

diff --git a/man/whom.man b/man/whom.man
index 49942707ebc23e2343329ea4354d5cd4f9909c20..63ab4b63a8e3ba8144020ed52f586ab3532602de 100644 (file)
--- a/man/whom.man
+++ b/man/whom.man
@@ -1,13 +1,15 @@
-.TH WHOM %manext1% "July 11, 2012" "%nmhversion%"
-.\"
+.TH WHOM %manext1% 2016-09-23 "%nmhversion%"
+.

 .\" %nmhwarning%
 .\" %nmhwarning%

-.\"
+.

 .SH NAME
 .SH NAME

-whom \- report to whom a message would go
+whom \- show to whom an nmh message would be sent

 .SH SYNOPSIS
 .HP 5
 .na
 .B whom
 .SH SYNOPSIS
 .HP 5
 .na
 .B whom

+.RB [ \-help ]
+.RB [ \-version ]

 .RB [ \-alias
 .IR aliasfile ]
 .RB [ \-check " | " \-nocheck ]
 .RB [ \-alias
 .IR aliasfile ]
 .RB [ \-check " | " \-nocheck ]


@@ -29,14 +31,13 @@ whom \- report to whom a message would go
 .RB [ \-user
 .IR username ]
 .RB [ \-tls ]
 .RB [ \-user
 .IR username ]
 .RB [ \-tls ]

+.RB [ \-initialtls ]

 .RB [ \-notls ]
 .RI [ file ]
 .RB [ \-draft ]
 .RB [ \-notls ]
 .RI [ file ]
 .RB [ \-draft ]

-.RB [ \-version ]
-.RB [ \-help ]

 .ad
 .SH DESCRIPTION
 .ad
 .SH DESCRIPTION

-.B Whom
+.B whom

 is used to expand the headers of a message into a set of
 addresses and optionally verify that those addresses are deliverable at
 that time (if
 is used to expand the headers of a message into a set of
 addresses and optionally verify that those addresses are deliverable at
 that time (if


@@ -53,13 +54,13 @@ switches invoke
 the
 .B nmh
 draft folder facility.  This is an advanced (and highly
 the
 .B nmh
 draft folder facility.  This is an advanced (and highly

-useful) feature.  Consult the
+useful) feature.  Consult

 .IR mh-draft (5)
 .IR mh-draft (5)

-man page for more information.
+for more information.

 .PP
 The mail transport system default is provided in
 .PP
 The mail transport system default is provided in

-.I %etcdir%/mts.conf
-but can be overriiden here with the
+.I %nmhetcdir%/mts.conf
+but can be overridden here with the

 .B \-mts
 switch.
 .PP
 .B \-mts
 switch.
 .PP


@@ -68,8 +69,8 @@ If nmh is using the SMTP MTA, the
 and the
 .B \-port
 switches can be used to override the default mail server (defined by the
 and the
 .B \-port
 switches can be used to override the default mail server (defined by the

-.I %etcdir%/mts.conf
-.RI servers
+.I %nmhetcdir%/mts.conf
+.I servers

 entry).  The
 .B \-snoop
 switch can be used to view the SMTP transaction.  (Beware that the
 entry).  The
 .B \-snoop
 switch can be used to view the SMTP transaction.  (Beware that the


@@ -84,38 +85,48 @@ 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
 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).
+.I netrc
+file can be used to store this password, as described in
+.IR mh-profile (5)).
+The

 .B \-saslmech
 switch can be used to select a particular SASL mechanism,
 .B \-saslmech
 switch can be used to select a particular SASL mechanism,

-and the the
+and the

 .B \-user
 .B \-user

-switch can be used to select a authorization userid
-to provide to SASL other than the default.
+switch can be used to select a authorization userid to provide to SASL
+other than the default.  The credentials profile entry in
+.IR mh\-profile (5)
+describes the ways to supply a username and
+password.

 .PP
 .PP

-If SASL authentication is successful, 
-.BR nmh
+If SASL authentication is successful,
+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
 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.
+switch; see
+.IR post (8)'s
+description of
+.B \-snoop
+for its other features.

 .PP
 If
 .B nmh
 has been compiled with TLS support, the
 .PP
 If
 .B nmh
 has been compiled with TLS support, the

-.B \-tls
+.BR \-tls ,
+.BR \-initialtls ,

 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
 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
+`(tls-decrypted)' when viewing the SMTP transaction with the

 .B \-snoop
 .B \-snoop

-switch.
+switch; see
+.IR post (8)'s
+description of
+.B \-snoop
+and the TLS flags for more details.

 .PP
 The files specified by the profile entry \*(lqAliasfile:\*(rq and any
 additional alias files given by the
 .PP
 The files specified by the profile entry \*(lqAliasfile:\*(rq and any
 additional alias files given by the


@@ -124,14 +135,14 @@ additional alias files given by the
 switch will be
 read (more than one file, each preceded by
 .BR \-alias ,
 switch will be
 read (more than one file, each preceded by
 .BR \-alias ,

-can be named). See
+can be named).  See

 .IR mh\-alias (5)
 for more information.
 .SH FILES
 .fc ^ ~
 .nf
 .IR mh\-alias (5)
 for more information.
 .SH FILES
 .fc ^ ~
 .nf

-.ta \w'%etcdir%/ExtraBigFileName  'u
-^$HOME/\&.mh\(ruprofile~^The user profile
+.ta \w'%nmhetcdir%/ExtraBigFileName  'u
+^$HOME/.mh_profile~^The user profile

 .fi
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .fi
 .SH "PROFILE COMPONENTS"
 .fc ^ ~


@@ -139,18 +150,19 @@ for more information.
 .ta 2.4i
 .ta \w'ExtraBigProfileName  'u
 ^Path:~^To determine the user's nmh directory
 .ta 2.4i
 .ta \w'ExtraBigProfileName  'u
 ^Path:~^To determine the user's nmh directory

-^Draft\-Folder:~^To find the default draft\-folder
+^Draft\-Folder:~^To find the default draft-folder

 ^Aliasfile:~^For a default alias file
 ^postproc:~^Program to post the message
 .fi
 .SH "SEE ALSO"
 .IR mh\-alias (5),
 ^Aliasfile:~^For a default alias file
 ^postproc:~^Program to post the message
 .fi
 .SH "SEE ALSO"
 .IR mh\-alias (5),

+.IR mh\-profile (5),

 .IR post (8)
 .SH DEFAULTS
 .nf
 .IR post (8)
 .SH DEFAULTS
 .nf

-.RB ` file "' defaults to <mh\-dir>/draft"
+.RB ` file "' defaults to <mh-dir>/draft"

 .RB ` \-nocheck '
 .RB ` \-nocheck '

-.RB ` \-alias "' defaults to  %etcdir%/MailAliases"
+.RB ` \-alias "' defaults to  %nmhetcdir%/MailAliases"

 .fi
 .SH CONTEXT
 None
 .fi
 .SH CONTEXT
 None