path: root/src/corelib/doc
diff options
authorAlejandro Exojo <>2014-12-09 18:21:07 +0100
committerAlejandro Exojo Piqueras <>2014-12-10 11:09:25 +0100
commitdd670a2f3dfaff00016c24468f1f6e66efbcd2c3 (patch)
treea2b78f65be402167e56a7571fa9c5cbe0cd28bc5 /src/corelib/doc
parentf17d7a124f0fa817a7e1a2dda6f48098432c0dc0 (diff)
doc: Clarify NOTIFY emission with MEMBER variables
Document that NOTIFY signals should be emitted only when really needed, and that such is the case with MEMBER variables. Change-Id: Icc38a0790aa43ffe8f24d124da966b4240a41a6f Reviewed-by: Olivier Goffart <>
Diffstat (limited to 'src/corelib/doc')
1 files changed, 4 insertions, 1 deletions
diff --git a/src/corelib/doc/src/objectmodel/properties.qdoc b/src/corelib/doc/src/objectmodel/properties.qdoc
index 8a6c7f53d9..dbdc080dff 100644
--- a/src/corelib/doc/src/objectmodel/properties.qdoc
+++ b/src/corelib/doc/src/objectmodel/properties.qdoc
@@ -97,7 +97,10 @@
of the property changes.
\c NOTIFY signals for \c MEMBER variables must take zero or one parameter,
which must be of the same type as the property. The parameter will take the
- new value of the property.
+ new value of the property. The \c NOTIFY signal should only be emitted when
+ the property has really been changed, to avoid bindings being unnecessarily
+ re-evaluated in QML, for example. Qt emits automatically that signal when
+ needed for MEMBER properties that do not have an explicit setter.
\li A \c REVISION number is optional. If included, it defines
the property and its notifier signal to be used in a particular