diff --git a/man/systemd.netdev.xml b/man/systemd.netdev.xml
index aefe89fc16..4e65885295 100644
--- a/man/systemd.netdev.xml
+++ b/man/systemd.netdev.xml
@@ -34,10 +34,16 @@
for a general description of the syntax.
The main Virtual Network Device file must have the extension .netdev;
- other extensions are ignored. Virtual network devices are created as soon as networkd is
- started. If a netdev with the specified name already exists, networkd will use that as-is rather
- than create its own. Note that the settings of the pre-existing netdev will not be changed by
- networkd.
+ other extensions are ignored. Virtual network devices are created as soon as
+ systemd-networkd is started if possible. If a netdev with the specified name already
+ exists, systemd-networkd will try to update the config if the kind of the existing
+ netdev is equivalent to the requested one, otherwise (e.g. when bridge device foo
+ exists but bonding device with the same name is configured in a .netdev file) use the existing netdev
+ as-is rather than replacing with the requested netdev. Note, several settings (e.g. vlan ID) cannot be
+ changed after the netdev is created. To change such settings, it is necessary to first remove the
+ existing netdev, and then run networkctl reload command or restart
+ systemd-networkd. See also
+ networkctl1.
The .netdev files are read from the files located in the system network
directory /usr/lib/systemd/network and