improve archive IQ code documentation

2 files changed, 51 insertions, 2 deletions

diff --git a/src/QXmppArchiveIq.cpp b/src/QXmppArchiveIq.cpp
index d2bd238e..8aaf8410 100644
--- a/src/QXmppArchiveIq.cpp
+++ b/src/QXmppArchiveIq.cpp
@@ -139,41 +139,69 @@ QList<QXmppArchiveChat> QXmppArchiveListIq::chats() const
     return m_chats;
 }
 
+/// Returns the maximum number of results.
+///
+
 int QXmppArchiveListIq::max() const
 {
     return m_max;
 }
 
+/// Sets the maximum number of results.
+///
+/// \param max
+
 void QXmppArchiveListIq::setMax(int max)
 {
     m_max = max;
 }
 
+/// Returns the JID which archived conversations must match.
+///
+
 QString QXmppArchiveListIq::with() const
 {
     return m_with;
 }
 
+/// Sets the JID which archived conversations must match.
+///
+/// \param with
+
 void QXmppArchiveListIq::setWith(const QString &with)
 {
     m_with = with;
 }
 
+/// Returns the start date/time for the archived conversations.
+///
+
 QDateTime QXmppArchiveListIq::start() const
 {
     return m_start;
 }
 
+/// Sets the start date/time for the archived conversations.
+///
+/// \param start
+
 void QXmppArchiveListIq::setStart(const QDateTime &start)
 {
     m_start = start;
 }
 
+/// Returns the end date/time for the archived conversations.
+///
+
 QDateTime QXmppArchiveListIq::end() const
 {
     return m_end;
 }
 
+/// Sets the end date/time for the archived conversations.
+///
+/// \param end
+
 void QXmppArchiveListIq::setEnd(const QDateTime &end)
 {
     m_end = end;
@@ -255,31 +283,52 @@ QXmppArchiveRetrieveIq::QXmppArchiveRetrieveIq()
 {
 }
 
+/// Returns the maximum number of results.
+///
+
 int QXmppArchiveRetrieveIq::max() const
 {
     return m_max;
 }
 
+/// Sets the maximum number of results.
+///
+/// \param max
+
 void QXmppArchiveRetrieveIq::setMax(int max)
 {
     m_max = max;
 }
 
+/// Returns the start date/time for the archived conversations.
+///
+
 QDateTime QXmppArchiveRetrieveIq::start() const
 {
     return m_start;
 }
 
+/// Sets the start date/time for the archived conversations.
+///
+/// \param start
+
 void QXmppArchiveRetrieveIq::setStart(const QDateTime &start)
 {
     m_start = start;
 }
 
+/// Returns the JID which archived conversations must match.
+///
+
 QString QXmppArchiveRetrieveIq::with() const
 {
     return m_with;
 }
 
+/// Sets the JID which archived conversations must match.
+///
+/// \param with
+
 void QXmppArchiveRetrieveIq::setWith(const QString &with)
 {
     m_with = with;
diff --git a/src/QXmppArchiveIq.h b/src/QXmppArchiveIq.h
index 904e21a5..10f28609 100644
--- a/src/QXmppArchiveIq.h
+++ b/src/QXmppArchiveIq.h
@@ -143,10 +143,10 @@ public:
     void setMax(int max);
 
     QDateTime start() const;
-    void setStart( const QDateTime &start );
+    void setStart(const QDateTime &start);
 
     QString with() const;
-    void setWith( const QString &with );
+    void setWith(const QString &with);
 
     static bool isArchiveRetrieveIq(const QDomElement &element);