qtmobility/src/contacts/qcontactabstractrequest.cpp
changeset 5 453da2cfceef
parent 4 90517678cc4f
child 11 06b8e2af4411
--- 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)
 {
 }