diff --git a/man/NetworkManager.conf.xml b/man/NetworkManager.conf.xml
index 333b0027f2..634928f583 100644
--- a/man/NetworkManager.conf.xml
+++ b/man/NetworkManager.conf.xml
@@ -823,6 +823,11 @@ domains=ALL
       and these default values only matter if the per-profile values explicitly indicates
       to use the default from <literal>NetworkManager.conf</literal>.
     </para>
+    <para>
+      Note that while nmcli supports various aliases and convenience features for configuring
+      properties, the settings in this section do not. For example, enum values usually only
+      can be configured via their numeric magic number.
+    </para>
     <para>
       Example:
 <programlisting>