man: clarify requirements for BridgeVLAN to work

(cherry picked from commit 4207abb6e108ada8b24f2008533090f318b789e4)

diff --git a/man/systemd.network.xml b/man/systemd.network.xml
index 9fbc0dc07dcdc49935dedf967c3a9fc4291e54e1..42fe3413fb92cc63f9ab24e31f257e707aa438a5 100644 (file)
--- a/man/systemd.network.xml
+++ b/man/systemd.network.xml
@@ -6319,15 +6319,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'>