diff --git a/src/dbus/qdbusmessage.cpp b/src/dbus/qdbusmessage.cpp
index b89ab6a3988..98689ab0b4c 100644
--- a/src/dbus/qdbusmessage.cpp
+++ b/src/dbus/qdbusmessage.cpp
@@ -743,6 +743,9 @@ bool QDBusMessage::isInteractiveAuthorizationAllowed() const
     Sets the arguments that are going to be sent over D-Bus to \a arguments. Those
     will be the arguments to a method call or the parameters in the signal.
 
+    Note that QVariantMap with invalid QVariant as value is not allowed
+    in \a arguments.
+
     \sa arguments()
 */
 void QDBusMessage::setArguments(const QList<QVariant> &arguments)