diff -r 90517678cc4f -r 453da2cfceef qtmobility/src/contacts/qcontactabstractrequest.cpp --- 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) { }