Add missing QT_{BEGIN,END}_NAMESPACE

[profile/ivi/qtdeclarative.git] / src / qml / qml / qqmlparserstatus.cpp

diff --git a/src/qml/qml/qqmlparserstatus.cpp b/src/qml/qml/qqmlparserstatus.cpp
index d4e415a..b895034 100644 (file)
--- a/src/qml/qml/qqmlparserstatus.cpp
+++ b/src/qml/qml/qqmlparserstatus.cpp
@@ -45,7 +45,8 @@ QT_BEGIN_NAMESPACE
 
 /*!
     \class QQmlParserStatus
-    \since 4.7
+    \since 5.0
+    \inmodule QtQml
     \brief The QQmlParserStatus class provides updates on the QML parser state.
 
     QQmlParserStatus provides a mechanism for classes instantiated by
@@ -59,6 +60,13 @@ QT_BEGIN_NAMESPACE
     when the \c font is assigned, and relayout again when the \c width is assigned,
     and so on).
 
+    Be aware that QQmlParserStatus methods are only called when a class is instantiated
+    by a QQmlEngine. If you create the same class directly from C++, these methods will
+    not be called automatically. To avoid this problem, it is recommended that you start
+    deferring operations from classBegin instead of from the initial creation of your class.
+    This will still prevent multiple revaluations during initial binding assignment in QML,
+    but will not defer operations invoked from C++.
+
     To use QQmlParserStatus, you must inherit both a QObject-derived class
     and QQmlParserStatus, and use the Q_INTERFACES() macro.
 
@@ -75,6 +83,8 @@ QT_BEGIN_NAMESPACE
         void componentComplete();
     }
     \endcode
+
+    The QtQuick 1.0 version of this class is named QDeclarativeParserStatus.
 */
 
 /*! \internal */