reference.conf: Make it clearer connect {} blocks are reciprocal

diff --git a/doc/reference.conf b/doc/reference.conf
index b28a3f0f31313b3145c4b5bd77eda88ac97778ab..54a07358760cd712a732d887d12551306bc465c3 100644 (file)
--- a/doc/reference.conf
+++ b/doc/reference.conf
@@ -546,14 +546,21 @@ operator "god" {
        privset = "admin";
 };
 
-/* connect {}: controls servers we connect to (OLD C:, N:, H:, L:) */
+/* connect {}: controls servers we connect with (OLD C:, N:, H:, L:).
+ *
+ * This configuration is used whether connections are incoming or
+ * outgoing.
+ */
 connect "irc.uplink.com" {
        /* the name of the other server must go above. It should match the
         * other server's name in its serverinfo {} block, and does not
-        * need to be an actual hostname. */
+        * need to be an actual hostname.
+        */
 
-       /* host: the host or IP to connect to.  If a hostname is used it
-        * must match the reverse dns of the server.
+       /* host: the host or IP to connect to.
+        *
+        * It is also used to validate incoming connections. If a hostname
+        * is used, it must match the reverse dns of the server.
         */
        host = "203.0.113.3";