improve QXmppDiscoveryManager code documentation

2 files changed, 43 insertions, 1 deletions

diff --git a/src/QXmppDiscoveryManager.cpp b/src/QXmppDiscoveryManager.cpp
index ee93babf..e481beb5 100644
--- a/src/QXmppDiscoveryManager.cpp
+++ b/src/QXmppDiscoveryManager.cpp
@@ -71,6 +71,11 @@ bool QXmppDiscoveryManager::handleStanza(const QDomElement &element)
     return false;
 }
 
+/// Requests information from the specified XMPP entity.
+///
+/// \param jid  The target entity's JID.
+/// \param node The target node (optional).
+
 QString QXmppDiscoveryManager::requestInfo(const QString& jid, const QString& node)
 {
     QXmppDiscoveryIq request;
@@ -86,6 +91,11 @@ QString QXmppDiscoveryManager::requestInfo(const QString& jid, const QString& no
         return "";
 }
 
+/// Requests items from the specified XMPP entity.
+///
+/// \param jid  The target entity's JID.
+/// \param node The target node (optional).
+
 QString QXmppDiscoveryManager::requestItems(const QString& jid, const QString& node)
 {
     QXmppDiscoveryIq request;
@@ -146,32 +156,61 @@ QXmppDiscoveryIq QXmppDiscoveryManager::capabilities()
     return iq;
 }
 
-/// http://xmpp.org/registrar/disco-categories.html#client
+/// Sets the category of the local XMPP client.
+///
+/// You can find a list of valid categories at:
+/// http://xmpp.org/registrar/disco-categories.html
+///
+/// \param category
+
 void QXmppDiscoveryManager::setClientCategory(const QString& category)
 {
     m_clientCategory = category;
 }
 
+/// Sets the type of the local XMPP client.
+///
+/// You can find a list of valid types at:
+/// http://xmpp.org/registrar/disco-categories.html
+///
+/// \param type
+
 void QXmppDiscoveryManager::setClientType(const QString& type)
 {
     m_clientType = type;
 }
 
+/// Sets the name of the local XMPP client.
+///
+/// \param name
+
 void QXmppDiscoveryManager::setClientName(const QString& name)
 {
     m_clientName = name;
 }
 
+/// Returns the category of the local XMPP client.
+///
+/// By default this is "client".
+
 QString QXmppDiscoveryManager::clientCategory()
 {
     return m_clientCategory;
 }
 
+/// Returns the type of the local XMPP client.
+///
+/// By default this is "pc".
+
 QString QXmppDiscoveryManager::clientType()
 {
     return m_clientType;
 }
 
+/// Returns the name of the local XMPP client.
+///
+/// By default this is "Based on QXmpp x.y.z".
+
 QString QXmppDiscoveryManager::clientName()
 {
     return m_clientName;
diff --git a/src/QXmppDiscoveryManager.h b/src/QXmppDiscoveryManager.h
index ab2c5630..6460fd7d 100644
--- a/src/QXmppDiscoveryManager.h
+++ b/src/QXmppDiscoveryManager.h
@@ -58,7 +58,10 @@ public:
     /// \endcond
 
 signals:
+    /// This signal is emitted when an information response is received.
     void infoReceived(const QXmppDiscoveryIq&);
+
+    /// This signal is emitted when an items response is received.
     void itemsReceived(const QXmppDiscoveryIq&);
 
 private: