--- a/qtmobility/src/contacts/qcontactabstractrequest.cpp Mon May 03 13:18:40 2010 +0300
+++ b/qtmobility/src/contacts/qcontactabstractrequest.cpp Fri May 14 16:41:33 2010 +0300
@@ -56,7 +56,19 @@
\ingroup contacts-main
It allows a client to asynchronously request some functionality of a
- particular QContactManager.
+ particular QContactManager. Instances of the class will emit signals
+ when the state of the request changes, or when more results become
+ available.
+
+ Clients should not attempt to create instances of this class directly,
+ but should instead use the use-case-specific classes derived from this
+ class.
+
+ After creating any sort of request, the client retains ownership and
+ must delete the request to avoid leaking memory. The client may either
+ do this directly (if not within a slot connected to a signal emitted
+ by the request) or by using the deleteLater() slot to schedule the
+ request for deletion when control returns to the event loop.
*/
/*!
@@ -101,16 +113,17 @@
*/
/*!
- \fn QContactAbstractRequest::QContactAbstractRequest()
- Constructs a new, invalid asynchronous request
+ \fn QContactAbstractRequest::QContactAbstractRequest(QObject* parent)
+ Constructs a new, invalid asynchronous request with the specified \a parent
*/
/*!
\internal
- Constructs a new request from the given request data \a otherd
+ Constructs a new request from the given request data \a otherd with
+ the given parent \a parent
*/
-QContactAbstractRequest::QContactAbstractRequest(QContactAbstractRequestPrivate* otherd)
- : d_ptr(otherd)
+QContactAbstractRequest::QContactAbstractRequest(QContactAbstractRequestPrivate* otherd, QObject* parent)
+ : QObject(parent), d_ptr(otherd)
{
}