man,NEWS: mention that all previously assigned VLAN IDs are cleared

Addresses https://github.com/systemd/systemd/pull/29987#issuecomment-1863934902.

diff --git a/NEWS b/NEWS
index f5d0df58b53354ad5d9e2d167f116010c2fb15ac..b1e7779b6027c75a3fa53bacbcb52714dbceb1ce 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -4,6 +4,12 @@ CHANGES WITH 256 in spe:
 
         Announcements of Future Feature Removals and Incompatible Changes:
 
+        * Previously, systemd-networkd did not explicitly remove any bridge VLAN
+          IDs assigned on bridge master and ports. Since v256, if a .network
+          file for an interface has at least one valid settings in [BridgeVLAN]
+          section, then all assigned VLAN IDs on the interface that are not
+          configured in the .network file are removed.
+
 CHANGES WITH 255:
 
         Announcements of Future Feature Removals and Incompatible Changes:

diff --git a/man/systemd.network.xml b/man/systemd.network.xml
index cf26a24405b79c1cdd751efc7c2b907769ac820b..7dc447d0a7f84b690bf4a3044edb7bac0679e7a7 100644 (file)
--- a/man/systemd.network.xml
+++ b/man/systemd.network.xml
@@ -5865,10 +5865,17 @@ ServerAddress=192.168.0.1/24</programlisting>
 
   <refsect1>
     <title>[BridgeVLAN] Section Options</title>
-    <para>The [BridgeVLAN] section manages the VLAN ID configuration of a bridge port and accepts the
-    following keys. Specify several [BridgeVLAN] sections to configure several VLAN entries. The
-    <varname>VLANFiltering=</varname> option has to be enabled, see the [Bridge] section in
-    <citerefentry><refentrytitle>systemd.netdev</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
+    <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,
+      <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
+      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.
+    </para>
 
     <variablelist class='network-directives'>
       <varlistentry>