man: update documentation for 'networkctl reload'

diff --git a/man/networkctl.xml b/man/networkctl.xml
index 9e2a65b879a3f59da90c91ad30faf4f20c5a1cb8..22f9744c955faa33d1e2a0ade22b108c571b2693 100644 (file)
--- a/man/networkctl.xml
+++ b/man/networkctl.xml
@@ -413,14 +413,23 @@ s - Service VLAN, m - Two-port MAC Relay (TPMR)
         <term>
           <command>reload</command>
         </term>
-        <listitem><para>Reload <filename>.netdev</filename> and <filename>.network</filename> files.
-        If a new <filename>.netdev</filename> file is found, then the corresponding netdev is created.
-        Note that even if an existing <filename>.netdev</filename> is modified or removed,
-        <command>systemd-networkd</command> does not update or remove the netdev.
-        If a new, modified or removed <filename>.network</filename> file is found, then all interfaces
-        which match the file are reconfigured.</para>
+        <listitem>
+          <para>Reload <filename>.netdev</filename> and <filename>.network</filename> files.</para>
+
+          <para>If a new or modified <filename>.netdev</filename> file is found, then the corresponding
+          netdev is created or updated, respectively. Note, if the corresponding interface already exists,
+          then some of new settings may not be applied. E.g., VLAN ID cannot be changed after the interface
+          was created, so changing [VLAN] <varname>Id=</varname> will not take effect if the matching VLAN
+          interface already exists. To apply such settings, the interfaces need to be removed manually before
+          reload. Also note that even if a <filename>.netdev</filename> file is removed,
+          <command>systemd-networkd</command> does not remove the existing netdev corresponding to the file.
+          </para>
 
-        <xi:include href="version-info.xml" xpointer="v244"/></listitem>
+          <para>If a new, modified, or removed <filename>.network</filename> file is found, then all
+          interfaces that matched the file are reconfigured.</para>
+
+          <xi:include href="version-info.xml" xpointer="v244"/>
+        </listitem>
       </varlistentry>
 
       <varlistentry>