Documentation

connection.go

@@ -112,7 +112,8 @@ func DialTLS(url string, amqps *tls.Config) (*Connection, error) {
 		}
 
 		// Use the URI's host for hostname validation unless otherwise set. Make a
-		// copy so not to modify the caller's reference.
+		// copy so not to modify the caller's reference when the caller reuses a
+		// tls.Config for a different URL.
 		if amqps.ServerName == "" {
 			c := *amqps
 			c.ServerName = uri.Host

doc.go

@@ -95,14 +95,14 @@ SSL/TLS - Secure connections
 When Dial encounters an amqps:// scheme, it will use the zero value of a
 tls.Config.  This will only perform server certificate and host verification.
 
-If you wish to provide a client certificate (recommended) or include a private
-certificate authority's certificate in the cert chain for server validity or
-run insecure by not verifying the server certificate dial your own connection
-then use DialTLS instead.  DialTLS will use the provided tls.Config when it
+Use DialTLS when you wish to provide a client certificate (recommended),
+include a private certificate authority's certificate in the cert chain for
+server validity, or run insecure by not verifying the server certificate dial
+your own connection.  DialTLS will use the provided tls.Config when it
+encounters an amqps:// scheme and will dial a plain connection when it
 encounters an amqp:// scheme.
 
-Running RabbitMQ for SSL/TLS is documented here:
-http://www.rabbitmq.com/ssl.html
+SSL/TLS in RabbitMQ is documented here: http://www.rabbitmq.com/ssl.html
 
 */
 package amqp