diff --git a/lib/mysql_connection.cpp b/lib/mysql_connection.cpp
index 02d50a07dc..8a4459419e 100644
--- a/lib/mysql_connection.cpp
+++ b/lib/mysql_connection.cpp
@@ -959,6 +959,10 @@ char * MySQL_Connection::connect_start_DNS_lookup() {
 		host_ip = connected_host_details.ip;
 	}
 	else {
+		// NOTE: DNS cache miss — hostname is passed directly to
+		// mysql_real_connect which resolves via the MariaDB client library
+		// using AF_UNSPEC. The mysql-resolution_family setting does NOT
+		// apply here; it only governs the DNS cache resolver thread.
 		host_ip = parent->address;
 	}
 	return host_ip;