diff --git a/man/networkctl.xml b/man/networkctl.xml
index 9e2a65b879..22f9744c95 100644
--- a/man/networkctl.xml
+++ b/man/networkctl.xml
@@ -413,14 +413,23 @@ s - Service VLAN, m - Two-port MAC Relay (TPMR)
reload
- Reload .netdev and .network files.
- If a new .netdev file is found, then the corresponding netdev is created.
- Note that even if an existing .netdev is modified or removed,
- systemd-networkd does not update or remove the netdev.
- If a new, modified or removed .network file is found, then all interfaces
- which match the file are reconfigured.
+
+ Reload .netdev and .network files.
-
+ If a new or modified .netdev file is found, then the corresponding
+ netdev is created or updated, respectively. Note, if the corresponding interface already exists,
+ then some of new settings may not be applied. E.g., VLAN ID cannot be changed after the interface
+ was created, so changing [VLAN] Id= will not take effect if the matching VLAN
+ interface already exists. To apply such settings, the interfaces need to be removed manually before
+ reload. Also note that even if a .netdev file is removed,
+ systemd-networkd does not remove the existing netdev corresponding to the file.
+
+
+ If a new, modified, or removed .network file is found, then all
+ interfaces that matched the file are reconfigured.
+
+
+