diff --git a/man/resolved.conf.xml b/man/resolved.conf.xml
index 3c56b76748..2b9f482971 100644
--- a/man/resolved.conf.xml
+++ b/man/resolved.conf.xml
@@ -75,7 +75,7 @@
Domains=
- A space-separated list of domains optionally prefixed with ~,
+ A space-separated list of domains, optionally prefixed with ~,
used for two distinct purposes described below. Defaults to the empty list.
Any domains not prefixed with ~ are used as search
@@ -86,17 +86,23 @@
/etc/resolv.conf with the search keyword are used instead, if
that file exists and any domains are configured in it.
- The domains prefixed with ~ are called "routing domains". All domains listed
- here (both search domains and routing domains after removing the ~ prefix) define
- a search path that preferably directs DNS queries to this interface. This search path has an effect
- only when suitable per-link DNS servers are known. Such servers may be defined through the
- DNS= setting (see above) and dynamically at run time, for example from DHCP
- leases. If no per-link DNS servers are known, routing domains have no effect.
+ The domains prefixed with ~ are called "route-only domains". All domains
+ listed here (both search domains and route-only domains after removing the
+ ~ prefix) define a search path that preferably directs DNS queries to this
+ interface. This search path has an effect only when suitable per-link DNS servers are known. Such
+ servers may be defined through the DNS= setting (see above) and dynamically at run
+ time, for example from DHCP leases. If no per-link DNS servers are known, route-only domains have no
+ effect.
Use the construct ~. (which is composed from ~ to
- indicate a routing domain and . to indicate the DNS root domain that is the
+ indicate a route-only domain and . to indicate the DNS root domain that is the
implied suffix of all DNS domains) to use the DNS servers defined for this link preferably for all
- domains.
+ domains.
+
+ See "Protocols and Routing" in
+ systemd-resolved.service8
+ for details of how search and route-only domains are used.
+