[PATCHv2 2/2] Documentation: git-send-email: correct statement about standard ports

["Wesley J. Landaker" <wjl@icecavern.net>]

On Friday 31 July 2009 10:04:39 Junio C Hamano wrote:
> As you noted, port 465 has been used as a well-known de-facto port to run
> SMTP over SSL at many places.  I do not think it would help anybody by
> clarifying that it is a "non-standard" port here.  This is not a place to
> educate people on which port they should run their SMTP servers.
>
> But I do not care deeply enough, and I can let it pass.
>
> I have much more trouble with that "like 465" than I have with "non
> standard".

If you don't like the phrasing, how about this revised patch? I call it a
"common SSL smtp port", and refer directly to 465. I think should make everyone
happy:

---

>From f0f6d41705f51f198c7cd87cbbf4ffdbe3fdf84e Mon Sep 17 00:00:00 2001
From: Wesley J. Landaker <wjl@icecavern.net>
Date: Thu, 30 Jul 2009 14:53:29 -0600
Subject: [PATCH 2/2] Documentation: git-send-email: correct statement about standard ports

The current documentation states that servers typically listen on port
465 and calls this "ssmtp". While it's true that many mail servers use
port 465 for SSL smtp, this is non-standard, and hails from the days
before smtp and submission TLS support, that arrived in RFC2487 and
RFC3207. Port 465 is actually assigned by IANA for unrelated purposes,
and is mostly still used by mail servers today only to support Outlook
Express.

In any case, this patch helps the documentation better reflect both
standards and reality, while still helpfully mentioning ports numbers
that a user may wish to specify.

Signed-off-by: Wesley J. Landaker <wjl@icecavern.net>
---
 Documentation/git-send-email.txt |    5 +++--
 1 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/Documentation/git-send-email.txt b/Documentation/git-send-email.txt
index 1c94351..767cf4d 100644
--- a/Documentation/git-send-email.txt
+++ b/Documentation/git-send-email.txt
@@ -142,8 +142,9 @@ user is prompted for a password while the input is masked for privacy.
 
 --smtp-server-port=<port>::
 	Specifies a port different from the default port (SMTP
-	servers typically listen to smtp port 25 and ssmtp port
-	465); symbolic port names (e.g. "submission" instead of 587)
+	servers typically listen to smtp port 25, but may also listen to
+	submission port 587, or the common SSL smtp port 465);
+	symbolic port names (e.g. "submission" instead of 587)
 	are also accepted. The port can also be set with the
 	'sendemail.smtpserverport' configuration variable.
 
-- 
1.6.3.1