correct smtp-ssl-cert-path description

The git-send-email documentation was never updated to reflect
the change made in 01645b74 to use the SSL library's default
CA trust store rather than /etc/ssl/certs as a hardcoded
default CApath. This corrects that, and also tweaks the rest
of the text a bit to explain more accurately what is required
for a valid CApath / CAfile.

Signed-off-by: Adam Williamson <awilliam@redhat.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>

diff --git a/Documentation/git-send-email.txt b/Documentation/git-send-email.txt
index f0e57a597b6e551d891c064fa69837db632237c6..21d2670496a9295da36975036f24100f3cc62f8b 100644 (file)
--- a/Documentation/git-send-email.txt
+++ b/Documentation/git-send-email.txt
@@ -199,10 +199,15 @@ must be used for each option.
        Legacy alias for '--smtp-encryption ssl'.
 
 --smtp-ssl-cert-path::
-       Path to ca-certificates (either a directory or a single file).
-       Set it to an empty string to disable certificate verification.
-       Defaults to the value set to the 'sendemail.smtpsslcertpath'
-       configuration variable, if set, or `/etc/ssl/certs` otherwise.
+       Path to a store of trusted CA certificates for SMTP SSL/TLS
+       certificate validation (either a directory that has been processed
+       by 'c_rehash', or a single file containing one or more PEM format
+       certificates concatenated together: see verify(1) -CAfile and
+       -CApath for more information on these). Set it to an empty string
+       to disable certificate verification. Defaults to the value of the
+       'sendemail.smtpsslcertpath' configuration variable, if set, or the
+       backing SSL library's compiled-in default otherwise (which should
+       be the best choice on most platforms).
 
 --smtp-user=<user>::
        Username for SMTP-AUTH. Default is the value of 'sendemail.smtpuser';