man: document that Domains=local bind the domain to unicast DNS, not mDNS

Fixes: #28983

diff --git a/man/resolved.conf.xml b/man/resolved.conf.xml
index 8edd6c94ef3ccf3cf7bba3435c85def83f3b77bf..d153865c6e33a2adc45a22b7e49e9b8b5f97665a 100644 (file)
--- a/man/resolved.conf.xml
+++ b/man/resolved.conf.xml
@@ -107,6 +107,13 @@
         <citerefentry><refentrytitle>systemd-resolved.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
         for details of how search and route-only domains are used.</para>
 
+        <para>Note that configuring the MulticastDNS domain <literal>local</literal> as search or routing
+        domain has the effect of routing lookups for this domain to classic unicast DNS. This may be used to
+        provide compatibility with legacy installations that use this domain in a unicast DNS context,
+        against the IANA assignment of this domain to pure MulticastDNS purposes. Search and routing domains
+        are a unicast DNS concept, they <emphasis>cannot</emphasis> be used to resolve single-label lookups
+        via MulticastDNS.</para>
+
         <xi:include href="version-info.xml" xpointer="v229"/>
         </listitem>
       </varlistentry>