man: clarify requirements for BridgeVLAN to work

diff --git a/man/systemd.network.xml b/man/systemd.network.xml
index 3e55d040b2fe028479691624321dddc70cf1ce86..2d22efd6357a83bd27f5db98e06afe29462bb6c2 100644 (file)
--- a/man/systemd.network.xml
+++ b/man/systemd.network.xml
@@ -6347,15 +6347,17 @@ ServerAddress=192.168.0.1/24</programlisting>
   <refsect1>
     <title>[BridgeVLAN] Section Options</title>
     <para>
-      The [BridgeVLAN] section manages the VLAN ID configurations of a bridge master or port, and accepts the
-      following keys. To make the settings in this section take an effect,
+      The [BridgeVLAN] section manages the VLAN ID configuration of a bridge master or enslaved device.
+      To make the settings in this section take an effect,
       <varname>VLANFiltering=</varname> option has to be enabled on the bridge master, see the [Bridge]
       section in
-      <citerefentry><refentrytitle>systemd.netdev</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
-      If at least one valid settings specified in this section in a .network file for an interface, all
-      assigned VLAN IDs on the interface that are not configured in the .network file will be removed. If
+      <citerefentry><refentrytitle>systemd.netdev</refentrytitle><manvolnum>5</manvolnum></citerefentry>, and
+      each enslaved device needs to define the relevant VLAN IDs in its own [BridgeVLAN] section, which it
+      has in common with the bridge master.
+      All assigned VLAN IDs on the interface that are not configured in the .network file will be removed. If
       VLAN IDs on an interface need to be managed by other tools, then the settings in this section cannot
-      be used in the matching .network file.
+      be used in the matching .network file and <varname>VLANFiltering=</varname> needs to be disabled on
+      the bridge master.
     </para>
 
     <variablelist class='network-directives'>