From: Thomas Haller <thaller@redhat.com>
Date: Thu, 31 Mar 2016 12:42:54 +0000 (+0200)
Subject: man: discourage use of monitor-connection-files=yes in NetworkManager.conf manual
X-Git-Url: https://iam.tj/gitweb/gitweb.cgi?p=NetworkManager.git;a=commitdiff_plain;h=4db69c5b520c15f25390a5b9c26db53c6397e5c8

man: discourage use of monitor-connection-files=yes in NetworkManager.conf manual

https://bugzilla.gnome.org/show_bug.cgi?id=764402
Related: https://bugzilla.redhat.com/show_bug.cgi?id=754677
Related: https://bugzilla.redhat.com/show_bug.cgi?id=1272617
---

diff --git a/man/NetworkManager.conf.xml.in b/man/NetworkManager.conf.xml.in
index 2a847f8f5..accbaf905 100644
--- a/man/NetworkManager.conf.xml.in
+++ b/man/NetworkManager.conf.xml.in
@@ -138,7 +138,13 @@ plugins-=remove-me
         the connection files at startup, and when explicitly requested
         via the ReloadConnections D-Bus call. If this key is set to
         '<literal>true</literal>', then NetworkManager will reload
-        connection files any time they changed.</para></listitem>
+        connection files any time they changed.
+        Automatic reloading is not adviced because there are race conditions
+        involved and it depends on the way how the editor updates the file.
+        In some situations, NetworkManager might first delete and add the
+        connection anew, instead of updating the existing one. Also, NetworkManager
+        might pick up incomplete settings while the user is still editing the files.
+        </para></listitem>
       </varlistentry>
       <varlistentry>
         <term><varname>auth-polkit</varname></term>