diff --git a/introspection/nm-exported-connection.xml b/introspection/nm-exported-connection.xml
index 0f2feeadf..f742e7d92 100644
--- a/introspection/nm-exported-connection.xml
+++ b/introspection/nm-exported-connection.xml
@@ -9,7 +9,7 @@
 
         <method name="Update">
           <tp:docstring>
-            Update the connection.
+            Update the connection with new settings and properties, replacing all previous settings and properties.
           </tp:docstring>
           <annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_exported_connection_update"/>
           <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>