From 28e3359fdcf5590014a3f36da385e6aa1459f7da Mon Sep 17 00:00:00 2001
From: Lennart Poettering <lennart@poettering.net>
Date: Wed, 8 Nov 2023 11:52:53 +0100
Subject: [PATCH] man: document that Domains=local bind the domain to unicast
 DNS, not mDNS

Fixes: #28983
---
 man/resolved.conf.xml | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/man/resolved.conf.xml b/man/resolved.conf.xml
index 8edd6c94ef3..d153865c6e3 100644
--- 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>
-- 
2.47.3