man: explain UseDomains a bit more

https://bugs.freedesktop.org/show_bug.cgi?id=85397

diff --git a/man/systemd.network.xml b/man/systemd.network.xml
index 5504b4646c6f2f1c3a702f5603630a0a80c505bc..bdbe239812c9394cc2dab9e11c65bd9dbd6244a8 100644 (file)
--- a/man/systemd.network.xml
+++ b/man/systemd.network.xml
@@ -228,6 +228,10 @@
             <para>Enables DHCPv4 and/or DHCPv6 support. Accepts
             <literal>yes</literal>, <literal>no</literal>,
             <literal>ipv4</literal>, or <literal>ipv6</literal>.</para>
+
+            <para>Please note that by default the domain name
+            specified through DHCP is not used for name resolution.
+            See option <option>UseDomains=</option> below.</para>
           </listitem>
         </varlistentry>
         <varlistentry>
@@ -529,6 +533,9 @@
             <para>When true (the default), the DNS servers received
             from the DHCP server will be used and take precedence over
             any statically configured ones.</para>
+
+            <para>This corresponds to the <option>nameserver</option>
+            option in <citerefentry project='man-pages'><refentrytitle>resolv.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
           </listitem>
         </varlistentry>
         <varlistentry>
@@ -567,7 +574,13 @@
           <listitem>
             <para>When true (not the default), the domain name
             received from the DHCP server will be used for DNS
-            resolution over this link.</para>
+            resolution over this link. When a name cannot be resolved
+            as specified, the domain name will be used a suffix and
+            name resolution of that will be attempted.</para>
+
+            <para>This corresponds to the <option>domain</option>
+            option in <citerefentry project='man-pages'><refentrytitle>resolv.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+            and should not be enabled on untrusted networks.</para>
           </listitem>
         </varlistentry>
         <varlistentry>