Home


    *****************************************************************************
    **
    ** API Change History
    **
    *****************************************************************************

    Changes since the QMF-1.0 release on 15/05/09:

    1. Added 'QMail::baseSubject(const QString &)',
             'QMail::messageIdentifiers(const QString &)',
             'QMail::messageServerPath()',
             'QMail::messageSettingsPath()', and
             'QMail::lastSystemErrorMessage()'.

    2. Extracted 'QMailMessageModelBase' from 'QMailMessageListModel'.

    3. Added 'QMailMessageThreadedModel'.

    4. Added 'QMailMessageKey::conversation(...)'.

    5. Added 'QMailStore::ContentNotRemoved'.

    6. Added 'QMailMessagePart::indicativeSize() const'.

    7. Added 'QMailMessagePartContainer::foreachPart(F)' and
             'QMailMessagePartContainer::foreachPart(F) const'.

    8. Added 'QMailAccount::CanReferenceExternalData' and
             'QMailAccount::CanTransmitViaReference'.

    9. Added 'QMailMessageMetaData::HasReferences' and
             'QMailMessageMetaData::HasUnresolvedReferences'.

    10. Added 'QMailMessageFwd::ChunkType' and
              'QMailMessageFwd::MessageChunk'.

    11. Added 'QMailMessage::toRfc2822Chunks(QMailMessage::EncodingFormat)'.

    12. Changed 'QMailAccountSortKey::status(Qt::SortOrder)' to
                'QMailAccountSortKey::status(quint64, Qt::SortOrder)',
                'QMailFolderSortKey::status(Qt::SortOrder)' to
                'QMailFolderSortKey::status(quint64, Qt::SortOrder)', and
                'QMailMessageSortKey::status(Qt::SortOrder)' to
                'QMailMessageSortKey::status(quint64, Qt::SortOrder)'.

    13. Added 'QMailMessagePartContainer::multipartTypeForName(const QByteArray&)' and
              'QMailMessagePartContainer::nameForMultipartType(QMailMessagePartContainer::MultipartType)'.

    14. Added 'QMailMessageMetaData::LocalOnly'.

    15. Added 'QMailMessage::contains(const QMailMessagePart::Location&) const'.

    16. Added 'void QMailMessageServer::actionStarted(QMailActionData)'.

    17. Added 'void QMailMessageServer::messagesFailedTransmission(quint64, const QMailMessageIdList&, QMailServiceAction::Status::ErrorCode)'.

    18. Added 'void QMailMessageServer::actionsListed(const QMailActionDataList &)' signal.

    19. Added 'void QMailMessageServer::listActions()' slot.

    20. Added 'QMailServiceAction(quint64 actionId, QObject *parent = 0)' constructor.

    21. Added 'QString QMailServiceAction::description()'

    22. Added 'void QMailRetrievalAction::messagesTransmitted(const QMailMessageIdList &ids)' signal.

    23. Added 'void QMailRetrievalAction::messagesFailedTransmission(const QMailMessageIdList &ids, QMailServiceAction::Status::ErrorCode)' signal.

    24. Added QMailActionInfo class.

    25. Added QMailActionObserver class.

    26. Added 'QMailMessage::Important', and
              'QMailMessage::ImportantElsewhere'.

    27. Added 'QMailStore::lock()' and
              'QMailStore::unlock()'.

    28. Added QMailActionInfo and QMailActionObserver classes.

    29. Added QMailDisconnected class.

    30. Changed 'QMailRetrievalAction::synchronize(const QMailAccountId &accountId)' to
                'QMailRetrievalAction::synchronizeAll(const QMailAccountId &accountId)'

    31. Added 'QMailDisconnected::destinationKey(const QMailFolderId &)'

    32. Added 'QMailRetrievalAction::synchronize(const QMailAccountId &accountId, uint minimum)'

    33. Added 'QMailAccount::lastSynchronized() const' and
              'QMailAccount::setSynchronized(const QMailTimeStamp &synced)'

    34. File Rename:
          qmf.pro -> messagingframework.pro (To avoid it conflicting with its child project)

        Library Renames:
          libmessageserver -> libqmfmessageserver
          libqtopiamail -> libqmf

        Directory Changes:
          src/libraries/messageserver -> src/libraries/qmfmessageserver
          src/libraries/qtopiamail -> src/libraries/qmf
          src/plugins/contentmanagers/qtopiamailfile -> qmfstoragemanager
          src/plugins/messageservices/qtopiamailfile -> qmfsettings

        Class changes:
          QtopiamailfileConfigurator -> QmfConfigurator
          QtopiamailfileSettings -> QmfSettings
          QtopiamailfileServicePlugin -> QmfServicePlugin
          QtopiamailfileManager -> QmfStorageManager

    35. Library rename:
          libqmf -> libqmfclient

        Directory Changes:
          src/libraries/qmf -> src/libraries/qmfclient

    36. Changed 'bool QMailStore::restoreToPreviousFolder(const QMailMessageId& id)' and
                'bool QMailStore::restoreToPreviousFolder(const QMailMessageKey& key)' to
                'void QMailDisconnected::restoreToPreviousFolder(const QMailMessageId& id)' and
                'void QMailDisconnected::restoreToPreviousFolder(const QMailMessageKey& key)'

    37. Added 'QMailStore::messageDataAdded(const QMailMessageMetaDataList &data)'
              'QMailStore::messageDataUpdated(const QMailMessageMetaDataList &data)
              'QMailStore::messagePropertyUpdated(const QMailMessageIdList& ids,
                                                  const QMailMessageKey::Properties& properties,
                                                  const QMailMessageMetaData& data)'
              'QMailStore::messageStatusUpdated(const QMailMessageIdList& ids,
                                                quint64 status, bool set)' signals.

    38. Remove unintentionally exported QMailId that should not have been included in the public API.

    39. Move Location inner class from QMailMessagePart to QMailMessagePartContainer

        Added following functions to QMailMessagePartContainer:
        'QMailMessagePartContainer* findPlainTextContainer() const'
        'QMailMessagePartContainer* findHtmlContainer() const'
        'QList<QMailMessagePartContainer::Location> findAttachmentLocations() const'
        'bool hasPlainTextBody() const'
        'bool hasHtmlBody() const'
        'bool hasAttachments() const'
        'void setPlainTextBody(const QMailMessageBody& plainTextBody)'
        'void setHtmlAndPlainTextBody(const QMailMessageBody& htmlBody, const QMailMessageBody& plainTextBody)'
        'void setAttachments(const QStringList& attachments)'
        'void setAttachments(const QList<const QMailMessagePart*> attachments)'

    40. Add 'QMailRetrievalAction::Auto'

    *****************************************************************************

    Changes since the development preview release on 03/04/09:

    1. Added 'QMailFolder::serverUndiscoveredCount() const' and
             'QMailFolder::setServerUndiscoveredCount()'.

    2. Added 'QMailStore::retrievalInProgress()',
             'QMailStore::setRetrievalInProgress()',
             'QMailStore::transmissionInProgress()' and
             'QMailStore::setTransmissionInProgress()'.

    3. Replaced 'QMailStore::initialized() const' and
                'QMailStore::storeInitialized()' with
                'QMailStore::InitializationState QMailStore::initializationState()'.

    4. Changed 'QMailMessageKey::status(...)',
               'QMailFolderKey::status(...)' and
               'QMailMessageKey::status(...)' so that the overload taking a QMailDataComparator::InclusionComparator has the default argument.


    *****************************************************************************

    Changes since the development preview release on 06/03/09:

    1. Added 'QMailContentManager::init()' and
             'QMailContentManagerFactory::init()'.

    2. Added 'QMailMessage::contentSize() const' and
             'QMailMessage::setContentSize(uint)'.

    3. Added 'QMailCodec::name() const',
             'QMailBase64Codec::name() const',
             'QMailQuotedPrintableCodec::name() const',
             'QMailPassThroughCodec::name() const' and
             'QMailLineEndingCodec::name() const'.


    *****************************************************************************

    Changes since the development preview release on 16/01/09:

    1. Added 'QMailAccountConfiguration::id() const'

    2. Added 'QMailMessagePart::Location::Location(const QString&)'

    3. Changed 'QMailMessagePart::Location::isValid() const' to
               'QMailMessagePart::Location::isValid(bool = true) const'.

    4. Added 'QMailMessagePart::setReference(const QMailMessageId&, const QMailMessageContentType&, QMailMessageBody::TransferEncoding)' and
             'QMailMessagePart::setReference(const QMailMessagePart::Location&, const QMailMessageContentType&, QMailMessageBody::TransferEncoding)'.

    5. Added 'QMailMessagePart::contentModified() const' and
             'QMailMessagePart::setUnmodified()'.

    6. Changed 'QMailMessageMetaData::dataModified() const' from private to public accessibility.

    7. Renamed 'QMailMessageMetaData::committed()' to
               'QMailMessageMetaData::setUnmodified()'.

    8. Changed 'QMailMessage::contentModified() const' from private to public accessibility.

    9. Added 'QMailStore::ErrorCode' enum.

    10. Added 'QMailStore::lastError() const',
              'QMailStore::errorOccurred(QMailStore::ErrorCode)' and
              'QMailStore::emitErrorNotification(QMailStore::ErrorCode)'.

    11. Added 'QMailStoreImplmentation::lastError() const',
              'QMailStoreImplmentation::setLastError() const' and
              'QMailStoreImplementation::errorCode'.

    12. Changed 'QMailContentManager::add(QMailMessage*)',
                'QMailContentManager::update(QMailMessage*)',
                'QMailContentManager::remove(const QString&)' and
                'QMailContentManager::load(const QString&, QMailMessage*)'
        to return QMailStore::ErrorCode instead of bool.

    13. Changed to use type-safe construction interface for 'QMailAccountKey',
                                                            'QMailFolderKey' and
                                                            'QMailMessageKey'.

    14. Changed to equivalent construction interface for 'QMailAccountSortKey',
                                                         'QMailFolderSortKey' and
                                                         'QMailMessageSortKey'.

    15. Removed 'QMailAccount::mailboxes() const',
                'QMailAccount::mailbox(const QString &)',
                'QMailAccount::serverUids() const',
                'QMailAccount::serverUids(const QMailFolderId &) const',
                'QMailAccount::serverUids(const QMailFolderId &, quint64, bool) const',
                'QMailAccount::deletedMessages() const' and
                'QMailAccount::deletedMessages(const QMailFolderId &) const'.

    16. Renamed 'QMailAccount::accountName() const' to 'QMailAccount::name() const',
                'QMailAccount::setAccountName(const QString &)' to 'QMailAccount::setName(const QString &)' and
                'QMailAccountKey::accountName()' to 'QMailAccountKey::name()'.

    17. Removed 'QMailAccount::displayName() const'.

    18. Renamed 'QMailFolder::name() const' to 'QMailFolder::path() const',
                'QMailFolder::setName(const QString &)' to 'QMailFolder::setPath(const QString &)' and
                'QMailFolderKey::name(...)' to 'QMailFolderKey::path(...)'.

    19. Renamed 'QMailFolder::parentId() const' to 'QMailFolder::parentFolderId() const',
                'QMailFolder::setParentId(const QMailFolderId &)' to 'QMailFolder::setParentFolderId(const QMailFolderId &)' and
                'QMailFolderKey::parentId(...)' to 'QMailFolderKey::parentFolderId(...)'.

    20. Added 'QMailMessageMetaData::receivedDate() const',
              'QMailMessageMetaData::setReceivedDate(const QMailTimeStamp &) const',
              'QMailMessageKey::receptionTimeStamp(...)' and
              'QMailMessageSortKey::receptionTimeStamp(...)'.

    21. Renamed 'QMailMessageSortKey::type(Qt::SortOrder)' to
                'QMailMessageSortKey::messageType(Qt::SortOrder)'.

    22. Added 'QMailMessagePart::Location::setContainingMessageId(const QMailMessageId &)'.

    23. Changed 'QMailRetrievalAction::retrieveMessagePart(const QMailMessageId &, const QMailMessagePart::Location &)' to
                'QMailRetrievalAction::retrieveMessagePart(QMailMessagePart::Location &)',
                'QMailRetrievalAction::retrieveMessagePartRange(const QMailMessageId &, const QMailMessagePart::Location &, uint)' to
                'QMailRetrievalAction::retrieveMessagePartRange(QMailMessagePart::Location &, uint)',
                'QMailMessageServer::retrieveMessagePart(const QMailMessageId &, const QMailMessagePart::Location &)' to
                'QMailMessageServer::retrieveMessagePart(QMailMessagePart::Location &)' and
                'QMailMessageServer::retrieveMessagePartRange(const QMailMessageId &, const QMailMessagePart::Location &, uint)' to
                'QMailMessageServer::retrieveMessagePartRange(QMailMessagePart::Location &, uint)'.

    24. Added 'Flags' value to 'QMailRetrievalAction::RetrievalSpecification'.

    25. Changed 'QMailRetrievalAction::retrieveAll(const QMailAccountId &, QMailRetrievalAction::RetrievalSpecification)' to
                'QMailRetrievalAction::retrieveAll(const QMailAccountId &)',
                'QMailRetrievalAction::synchronize(const QMailAccountId &, QMailRetrievalAction::RetrievalSpecification)' to
                'QMailRetrievalAction::synchronize(const QMailAccountId &)',
                'QMailMessageServer::retrieveAll(const QMailAccountId &, QMailRetrievalAction::RetrievalSpecification)' to
                'QMailMessageServer::retrieveAll(const QMailAccountId &)' and
                'QMailMessageServer::synchronize(const QMailAccountId &, QMailRetrievalAction::RetrievalSpecification)' to
                'QMailMessageServer::synchronize(const QMailAccountId &)'.

    26. Renamed 'QMailMessageMetaData::Downloaded' to 'QMailMessageMetaData::ContentAvailable'.

    27. Added 'QMailMessageMetaData::PartialContentAvailable' and 'QMailMessageMetaData::HasAttachments'.

    28. Added 'QMailMessagePartContainer::contentAvailable() const',
              'QMailMessagePartContainer::partialContentAvailable() const',
              'QMailMessageMetaData::contentAvailable() const' and
              'QMailMessageMetaData::partialContentAvailable() const'.

    29. Changed 'QMailMessageModelBase::emitDataChanged(const QModelIndex &idx)' to
                'QMailMessageModelBase::emitDataChanged(const QModelIndex &idx, const QModelIndex &jdx)'.

    *****************************************************************************


Copyright © 2010 QtSoftware
Messaging Framework