diff --git a/man/systemd-nspawn.xml b/man/systemd-nspawn.xml
index bd688a0ee1..57c0a223af 100644
--- a/man/systemd-nspawn.xml
+++ b/man/systemd-nspawn.xml
@@ -524,15 +524,23 @@
- Create a virtual Ethernet link
- (veth) between host and container. The host
- side of the Ethernet link will be available as a network
- interface named after the container's name (as specified with
- ), prefixed with
- ve-. The container side of the Ethernet
- link will be named host0. Note that
- implies
- .
+ Create a virtual Ethernet link (veth) between host and container. The host
+ side of the Ethernet link will be available as a network interface named after the container's name (as
+ specified with ), prefixed with ve-. The container side of the
+ Ethernet link will be named host0. The option implies
+ .
+
+ Note that
+ systemd-networkd.service8
+ includes by default a network file /usr/lib/systemd/network/80-container-ve.network
+ matching the host-side interfaces created this way, which contains settings to enable automatic address
+ provisioning on the created virtual link via DHCP, as well as automatic IP routing onto the host's external
+ network interfaces. It also contains /usr/lib/systemd/network/80-container-host0.network
+ matching the container-side interface created this way, containing settings to enable client side address
+ assignment via DHCP. In case systemd-networkd is running on both the host and inside the
+ container, automatic IP communication from the container to the host is thus available, with further
+ connectivity to the external network.
+
@@ -553,12 +561,10 @@
- Adds the host side of the Ethernet link
- created with to the specified
- bridge. Note that implies
- . If this option is used, the
- host side of the Ethernet link will use the
- vb- prefix instead of
+ Adds the host side of the Ethernet link created with to the
+ specified Ethernet bridge interface. Expects a valid network interface name of a bridge device as
+ argument. Note that implies . If this option
+ is used, the host side of the Ethernet link will use the vb- prefix instead of
ve-.