aboutsummaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
authorManjeet Dahiya <manjeetdahiya@gmail.com>2010-08-19 10:00:00 +0000
committerManjeet Dahiya <manjeetdahiya@gmail.com>2010-08-19 10:00:00 +0000
commitf1156d11735d2f8013682c9bfaa15d756e4fdd42 (patch)
tree4f47af72f07f2cacfa364c6c56a41ea793c1a9bd /src
parent311c513504d46dcf72867bf2184479775dad0647 (diff)
downloadqxmpp-f1156d11735d2f8013682c9bfaa15d756e4fdd42.tar.gz
doc part-1
Diffstat (limited to 'src')
-rw-r--r--src/QXmppVCardManager.h22
1 files changed, 20 insertions, 2 deletions
diff --git a/src/QXmppVCardManager.h b/src/QXmppVCardManager.h
index 16bb3ae0..7e30beda 100644
--- a/src/QXmppVCardManager.h
+++ b/src/QXmppVCardManager.h
@@ -31,8 +31,26 @@
class QXmppStream;
-/// \brief The QXmppVCardManager class makes it possible to interact
-/// with XMPP vCards.
+/// \brief The QXmppVCardManager gets/sets XMPP vCards. It is an
+/// implentation of <B>XEP-0054: vcard-temp</B>.
+///
+/// \note It's object should not be created using it's constructor. Instead
+/// QXmppClient::vCardManager() should be used to get the reference of instantiated
+/// object this class.
+///
+/// Getting vCards of entries in Roster:
+/// It doesn't store vCards of the JIDs in the roster of connected user. Instead
+/// client has to request for a particular vCard using requestVCard(). And connect to
+/// the signal vCardReceived() to get the requested vCard.
+///
+/// Getting vCard of the connected client:
+/// For getting the vCard of the connected user itself. Client can call requestClientVCard()
+/// and on the signal clientVCardReceived() it can get its vCard using clientVCard().
+///
+/// Settting vCard of the client:
+/// Using setClientVCard() client can set its vCard.
+///
+/// \note Client can't set set/change vCards of roster entries.
///
/// \ingroup Managers