X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/a722c223281c71fae98170f31b0b4738b5e67b1d..a0250745de00aacfe03f82bdcc7e5e86f0768dd7:/man/send.man diff --git a/man/send.man b/man/send.man index e3ea413c..a3003709 100644 --- a/man/send.man +++ b/man/send.man @@ -1,13 +1,15 @@ .\" .\" %nmhwarning% .\" -.TH SEND %manext1% "July 8, 2016" "%nmhversion%" +.TH SEND %manext1% "October 10, 2016" "%nmhversion%" .SH NAME send \- send a message .SH SYNOPSIS .HP 5 .na .B send +.RB [ \-help ] +.RB [ \-version ] .RB [ \-alias .IR aliasfile ] .RB [ \-draft ] @@ -40,8 +42,6 @@ send \- send a message .IR port-name/number ] .RB [ \-sasl ] .RB [ \-nosasl ] -.RB [ \-saslmaxssf -.IR ssf ] .RB [ \-saslmech .IR mechanism ] .RB [ \-authservice @@ -56,11 +56,9 @@ send \- send a message .IR columns ] .RB [ file \&...] -.RB [ \-version ] -.RB [ \-help ] .ad .SH DESCRIPTION -.B Send +.B send will cause each of the specified files to be delivered to each of the destinations in the \*(lqTo:\*(rq, \*(lqcc:\*(rq, \*(lqBcc:\*(rq, \*(lqDcc:\*(rq, and \*(lqFcc:\*(rq fields of the message. If @@ -238,7 +236,7 @@ lot of partial messages. The argument to tells it how long to pause between postings. .PP -.B Send +.B send with no .I file argument will query whether the draft @@ -265,7 +263,7 @@ If a \*(lqDcc:\*(rq field is encountered and the mail transport method is not in use, its addresses will be used for delivery, and the \*(lqDcc:\*(rq field will be removed from the message. The blind recipients will receive the same message sent to the sighted -recipients. *WARNING* Recipients listed in the \*(lqDcc:\*(rq field receive no +recipients. *WARNING* Recipients listed in the \*(lqDcc:\*(rq field receive no explicit indication that they have received a \*(lqblind copy\*(rq. This can cause blind recipients to inadvertently reply to all of the sighted recipients of the @@ -391,7 +389,7 @@ entry). The 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.) If -.B \-saslmech xoauth2 +.B \-sasl \-saslmech xoauth2 is used, the HTTP transaction is also shown. .PP If @@ -422,28 +420,31 @@ 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 the +.B post +man page description of +.B \-snoop +for its other features. .PP If .B nmh has been compiled with OAuth support, the +.B \-sasl +and .B \-saslmech xoauth2 -switch will enable OAuth authentication. The +switches will enable OAuth authentication. The .B \-user switch must be used, and the -.I user-name +.I username must be an email address the user has for the service, which must be specified with the .B \-authservice .I service -switch. Before using this, the user must authorize nmh by running +switch. Before using OAuth authentication, the user must authorize nmh by +running .B mhlogin and grant authorization to that account. See the -.B mhlogin +.IR mhlogin (1) man page for more details. .PP If @@ -463,7 +464,11 @@ taken place, before any SMTP commands are sent or received. Encrypted data is labelled with `(tls-encrypted)' and `(tls-decrypted)' when viewing the SMTP transction with the .B \-snoop -switch. +switch; see the +.B post +man page description of +.B \-snoop +for its other features. The .B \-notls switch will disable all attempts to negotiate TLS. @@ -515,7 +520,7 @@ Here is an example profile entry using OAuth for an account hosted by gmail: .PP .nf .RS 5 -sendfrom-gmail_address@example.com: -saslmech xoauth2 +sendfrom-gmail_address@example.com: -sasl -saslmech xoauth2 .RS 5 -authservice gmail -tls -server smtp.gmail.com -user gmail_login@example.com