Document use of address literals for SMTP.

1 files changed, 15 insertions, 5 deletions

diff --git a/fetchmail.man b/fetchmail.man
index c74fb5e5..0f7fc944 100644
--- a/fetchmail.man
+++ b/fetchmail.man
@@ -650,6 +650,10 @@ Example:
 .sp
 This option can be used with ODMR, and will make fetchmail a relay
 between the ODMR server and SMTP or LMTP receiver.
+.IP
+WARNING: if you use address numeric IP addresses here, be sure to use
+\-\-smtpaddress or \-\-smtpname (either of which see) with a valid SMTP
+address literal!
 .TP
 .B \-\-fetchdomains <hosts>
 (Keyword: fetchdomains)
@@ -661,16 +665,22 @@ default is the FQDN of the machine running \fBfetchmail\fP.
 .B \-D <domain> | \-\-smtpaddress <domain>
 (Keyword: smtpaddress)
 .br
-Specify the domain to be appended to addresses
-in RCPT TO lines shipped to SMTP. When this is not specified, the name
-of the SMTP server (as specified by \-\-smtphost) is used for SMTP/LMTP
-and 'localhost' is used for UNIX socket/BSMTP.
+Specify the domain to be appended to addresses in RCPT TO lines shipped
+to SMTP. When this is not specified, the name of the SMTP server (as
+specified by \-\-smtphost) is used for SMTP/LMTP and 'localhost' is used
+for UNIX socket/BSMTP.
+.IP
+NOTE: if you intend to use numeric addresses, or so-called address
+literals per the SMTP standard, write them in proper SMTP syntax, for
+instance \-\-smtpaddress "[192.0.2.6]" or \-\-smtpaddress
+"[IPv6:2001:DB8::6]".
 .TP
 .B \-\-smtpname <user@domain>
 (Keyword: smtpname)
 .br
 Specify the domain and user to be put in RCPT TO lines shipped to SMTP.
-The default user is the current local user.
+The default user is the current local user. Please also see the NOTE
+about \-\-smtpaddress and address literals above.
 .TP
 .B \-Z <nnn> | \-\-antispam <nnn[, nnn]...>
 (Keyword: antispam)