From 1128bceab92151b518745d8d70ea7441d38c3af4 Mon Sep 17 00:00:00 2001
From: Thomas Haller <thaller@redhat.com>
Date: Tue, 23 Jan 2024 13:44:41 +0100
Subject: [PATCH] doc: clarify limitation of parsing values in
 "NetworkManager.conf"

This really should be fixed, because it's a non-obvious limitation.
Anyway, document it for now.
---
 man/NetworkManager.conf.xml | 5 +++++
 1 file changed, 5 insertions(+)

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>