diff --git a/man/nmcli.1.in b/man/nmcli.1.in
index d07878c765..5e6197910b 100644
--- a/man/nmcli.1.in
+++ b/man/nmcli.1.in
@@ -878,6 +878,12 @@ modifies 'autoconnect' property in the 'connection' setting of 'ethernet\(hy2' c
 .IP
 modifies 'mtu' property in the 'wifi' setting of 'Home Wi\(hyFi' connection.
 
+.SH NOTES
+\fInmcli\fP accepts abbreviations, as long as they are a unique prefix in the set
+of possible options. As new options get added, these abbreviations are not guaranteed
+to stay unique. For scripting and long term compatiblity it is therefore strongly
+advised to spell out the full option names.
+
 .SH BUGS
 There are probably some bugs.  If you find a bug, please report it to
 https://bugzilla.gnome.org/ \(em product \fINetworkManager\fP.