diff --git a/man/NetworkManager.conf.xml b/man/NetworkManager.conf.xml
index 5a7f0d83d5..333b0027f2 100644
--- a/man/NetworkManager.conf.xml
+++ b/man/NetworkManager.conf.xml
@@ -868,7 +868,13 @@ ipv6.ip6-privacy=0
connection.mdns
- If unspecified, the ultimate default values depends on the DNS plugin. With systemd-resolved the default currently is "no" (0) and for all other plugins also "no" (0).
+
+ Currently only the systemd-resolve DNS plugin supports this setting.
+ If the setting is unspecified both in the profile and in the global
+ default here, then the default is determined by systemd-resolved.
+ See MulticastDNS= in
+ resolved.conf5.
+
connection.mptcp-flags
diff --git a/src/libnm-core-impl/nm-setting-connection.c b/src/libnm-core-impl/nm-setting-connection.c
index 892e7d3151..46121441da 100644
--- a/src/libnm-core-impl/nm-setting-connection.c
+++ b/src/libnm-core-impl/nm-setting-connection.c
@@ -2724,11 +2724,12 @@ nm_setting_connection_class_init(NMSettingConnectionClass *klass)
* for the connection, "no" (0) disable mDNS for the interface, "resolve"
* (1) do not register hostname but allow resolving of mDNS host names
* and "default" (-1) to allow lookup of a global default in NetworkManager.conf.
- * If unspecified, "default" ultimately depends on the DNS plugin (which
- * for systemd-resolved currently means "no").
+ * If unspecified, "default" ultimately depends on the DNS plugin.
*
* This feature requires a plugin which supports mDNS. Otherwise, the
- * setting has no effect. One such plugin is dns-systemd-resolved.
+ * setting has no effect. Currently the only supported DNS plugin is
+ * systemd-resolved. For systemd-resolved, the default is configurable via
+ * MulticastDNS= setting in resolved.conf.
*
* Since: 1.12
**/