From 759d8e415e541b0aac7a2ef7df909a770f58e851 Mon Sep 17 00:00:00 2001
From: Jeremy Lainé <jeremy.laine@m4x.org>
Date: Tue, 10 Aug 2010 06:15:03 +0000
Subject: add code documentation for QXmppArchiveManager

---
 source/QXmppArchiveManager.cpp | 17 +++++++++++++++++
 source/QXmppArchiveManager.h   |  1 -
 2 files changed, 17 insertions(+), 1 deletion(-)

(limited to 'source')

diff --git a/source/QXmppArchiveManager.cpp b/source/QXmppArchiveManager.cpp
index d15af80a..e89357b9 100644
--- a/source/QXmppArchiveManager.cpp
+++ b/source/QXmppArchiveManager.cpp
@@ -59,6 +59,14 @@ void QXmppArchiveManager::archivePrefIqReceived(const QXmppArchivePrefIq &prefIq
     Q_UNUSED(prefIq);
 }
 
+/// Retrieves the list of available collections. Once the results are
+/// received, the archiveChatReceived() signal will be emitted.
+///
+/// \param jid Optional JID if you only want conversations with a specific JID.
+/// \param start Optional start time.
+/// \param end Optional end time.
+/// \param max Optional maximum.
+///
 void QXmppArchiveManager::listCollections(const QString &jid, const QDateTime &start, const QDateTime &end, int max)
 {
     QXmppArchiveListIq packet;
@@ -69,6 +77,13 @@ void QXmppArchiveManager::listCollections(const QString &jid, const QDateTime &s
     m_stream->sendPacket(packet);
 }
 
+/// Retrieves the specified collection. Once the results are received,
+/// the archiveChatReceived() will be emitted.
+///
+/// \param jid The JID of the collection
+/// \param start The start time of the collection.
+/// \param max Optional maximum number of messages to retrieve.
+///
 void QXmppArchiveManager::retrieveCollection(const QString &jid, const QDateTime &start, int max)
 {
     QXmppArchiveRetrieveIq packet;
@@ -78,8 +93,10 @@ void QXmppArchiveManager::retrieveCollection(const QString &jid, const QDateTime
     m_stream->sendPacket(packet);
 }
 
+#if 0
 void QXmppArchiveManager::getPreferences()
 {
     QXmppArchivePrefIq packet;
     m_stream->sendPacket(packet);
 }
+#endif
diff --git a/source/QXmppArchiveManager.h b/source/QXmppArchiveManager.h
index 0acbf83a..dda13d0f 100644
--- a/source/QXmppArchiveManager.h
+++ b/source/QXmppArchiveManager.h
@@ -46,7 +46,6 @@ public:
     QXmppArchiveManager(QXmppStream* stream, QObject *parent = 0);
     void listCollections(const QString &jid, const QDateTime &start = QDateTime(), const QDateTime &end = QDateTime(), int max = 0);
     void retrieveCollection(const QString &jid, const QDateTime &start, int max = 0);
-    void getPreferences();
 
 signals:
     void archiveListReceived(const QList<QXmppArchiveChat>&);
-- 
cgit v1.2.3