diff --git a/doc/reference.conf b/doc/reference.conf
index b28a3f0f..54a07358 100644
--- 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";