dtimezone(): Explain abs(3) is undefined on INT_MIN.

[nmh] / man / whom.man

diff --git a/man/whom.man b/man/whom.man
index fc386bb0cef0bf7e234ca6342541ef4526aeb9ed..73456b0308fb99d5fddabb05193fc27e7fe736cc 100644 (file)
--- a/man/whom.man
+++ b/man/whom.man
@@ -1,29 +1,43 @@
-.\"
+.TH WHOM %manext1% 2016-09-23 "%nmhversion%"
+.

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

-.\"
-.TH WHOM %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.

 .SH NAME
 .SH NAME

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

 .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 ]

-.RB [ \-draft ]

 .RB [ \-draftfolder
 .IR +folder ]
 .RB [ \-draftmessage
 .IR msg ]
 .RB [ \-nodraftfolder ]
 .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 [ \-snoop ]

+.RB [ \-user
+.IR username ]
+.RB [ \-tls ]
+.RB [ \-initialtls ]
+.RB [ \-notls ]

 .RI [ file ]
 .RI [ file ]

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

 .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


@@ -41,15 +55,77 @@ the
 .B nmh
 draft folder facility.  This is an advanced (and highly
 useful) feature.  Consult 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
 man page for more information.
 .PP

-The
+The mail transport system default is provided in
+.I %nmhetcdir%/mts.conf
+but can be overridden 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 %nmhetcdir%/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
 .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
+.I netrc
+file can be used to store this password, as described in the
+mh-profile(5) man page).  The
+.B \-saslmech
+switch can be used to select a particular SASL mechanism,
+and the
+.B \-user
+switch can be used to select a authorization userid to provide to SASL
+other than the default.  The credentials profile entry in the
+mh\-profile(5) man page describes the ways to supply a username and
+password.
+.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; see the
+.B post
+man page description of
+.B \-snoop
+for its other features.
+.PP
+If
+.B nmh
+has been compiled with TLS support, the
+.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
+`(tls-decrypted)' when viewing the SMTP transaction with the
+.B \-snoop
+switch; see the
+.B post
+man page 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
 .B \-alias
 The files specified by the profile entry \*(lqAliasfile:\*(rq and any
 additional alias files given by the
 .B \-alias


@@ -57,41 +133,37 @@ 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
-.BR mh\-alias (5)
+can be named).  See
+.IR mh\-alias (5)

 for more information.
 for more information.

-

 .SH FILES
 .fc ^ ~
 .nf
 .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
 .fi

-

 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf
 .ta 2.4i
 .ta \w'ExtraBigProfileName  'u
 ^Path:~^To determine the user's nmh directory
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf
 .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
 ^Aliasfile:~^For a default alias file
 ^postproc:~^Program to post the message
 .fi

-

 .SH "SEE ALSO"
 .SH "SEE ALSO"

-mh\-alias(5), post(8)
-
+.IR mh\-alias (5),
+.IR mh\-profile (5),
+.IR post (8)

 .SH DEFAULTS
 .nf
 .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
 .fi

-

 .SH CONTEXT
 None
 .SH CONTEXT
 None

-

 .SH BUGS
 With the
 .B \-check
 .SH BUGS
 With the
 .B \-check