diff --git a/man/systemd.network.xml b/man/systemd.network.xml
index 5504b4646c..bdbe239812 100644
--- a/man/systemd.network.xml
+++ b/man/systemd.network.xml
@@ -228,6 +228,10 @@
Enables DHCPv4 and/or DHCPv6 support. Accepts
yes, no,
ipv4, or ipv6.
+
+ Please note that by default the domain name
+ specified through DHCP is not used for name resolution.
+ See option below.
@@ -529,6 +533,9 @@
When true (the default), the DNS servers received
from the DHCP server will be used and take precedence over
any statically configured ones.
+
+ This corresponds to the
+ option in resolv.conf5.
@@ -567,7 +574,13 @@
When true (not the default), the domain name
received from the DHCP server will be used for DNS
- resolution over this link.
+ 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.
+
+ This corresponds to the
+ option in resolv.conf5
+ and should not be enabled on untrusted networks.