qtcontactsmobility/DEPRECATION
changeset 40 b46a585f6909
parent 27 de1630741fbe
--- a/qtcontactsmobility/DEPRECATION	Thu May 27 12:45:19 2010 +0300
+++ b/qtcontactsmobility/DEPRECATION	Fri Jun 11 13:29:23 2010 +0300
@@ -1,4 +1,4 @@
-Deprecation guide (23 March 2010)
+Deprecation guide (8th April 2010)
 =================
 Known source breaks:
     There are a number of source breaks that nearly all just affect engine writers - marked with [!] in this document.  Largely
@@ -33,6 +33,11 @@
     Q_DECLARE_LATIN1_LITERAL -> Q_DECLARE_LATIN1_CONSTANT and Latin1Literal -> QLatin1Constant - Don't use the old ones.
     QContactRelationshipFilter::Role moved to QContactRelationship::Role (affects all places that deal with relationships)
     QContactLocalId - definition moved to qcontactid.h from qtcontactsglobal.h (old header includes new one right now)
+    dtors for a number of classes have been removed, since they were empty and will always be empty.
+    QContactDetails now use Latin1 strings as the keys for values (and for their definition name).  QString keys will still work.
+
+    Several classes have been adjusted so that they are now "small" (sizeof(class) <= sizeof(void*)) - this means
+    that lists/hashes/maps of them will be more efficient, but code needs recompilation.
 
 QContact:
     Deprecated members:
@@ -49,6 +54,7 @@
         All fetch functions taking a list of detail definitions to retrieve have been changed to use QContactFetchHint instead
         Some functions now take a const List<T>& rather than a List<T>*
         Functions returning a QList<QContactManager::Error> are replaced with parameters pointing to an error map to fill in
+        Constructors are now explicit.
     Deprecated members:
         2 x contacts(.. QStringList definitionRestrictions ..)  [use contacts functions that takes QContactFetchHint instead]
         contact(.. QStringList definitionRestrictions ..)       [use contact function that takes QContactFetchHint instead]
@@ -92,6 +98,11 @@
         setFetchHint()
 
 QContactDetail:
+    The ctors have been marked explicit, to avoid accidentally invoking a conversion from const char* or QString.
+    The keys for all values (and definition name) are now stored as latin1 strings (const char*), resulting in
+    significant memory and runtime savings.  QStrings used as keys will still work, but be converted to latin1
+    first.
+
     Deprecated members:
         preferredActions                  [No replacement]
         setPreferredActions                 [No replacement]
@@ -231,3 +242,22 @@
         Added ctors with iodevice and bytearray for destination
         startWriting() and cancel() are now slots
         waitForFinished() is now an invokable
+
+-----------------------
+Deprecated Guide (19th April 2010)
+
+QContact:
+    - QContact::detailWithAction(const QString& actionName) is deprecated
+    - QContact::detailsWithAction(const QString& actionName) is deprecated
+    -> these are replaced by QContact::detail(s)WithAction(QAction* actionPtr)
+
+QContactManager:
+    - QContactManager::synthesizedDisplayLabel(const QContact& contact) is deprecated
+    -> replaced by QContactManager::synthesizedContactDisplayLabel(const QContact& contact)
+
+QContactManagerEngine:
+    - functions no longer pure virtual.
+
+QContactDetailDefinitionRemoveRequest:
+    - QContactDetailDefinitionRemoveRequest::setDefinitionNames(const QString& contactType, const QStringList& definitionNames)) is deprecated
+    -> replaced by QContactDetailDefinitionRemoveRequest::setContactType(const QString& contactType) + QContactDetailDefinitionRemoveRequest::setDefinitionNames(const QStringList& definitionNames).