Changes between Version 4 and Version 5 of pjsip-doc/presence

Timestamp:

Feb 10, 2014 11:46:09 AM (11 years ago)

Author:

bennylp

Comment:

--

pjsip-doc/presence

@@ -4 +4 @@
 Buddy (Presence)
 ================
-This class represents a remote buddy (a person, or a SIP endpoint).
+Presence feature in PJSUA2 centers around Buddy class. This class represents a remote buddy (a person, or a SIP endpoint).
 
 Subclassing the Buddy class
 ----------------------------
-To use the Buddy class, normally application SHOULD create its own subclass, such as::
+To use the Buddy class, normally application SHOULD create its own subclass, such as:
+
+.. code-block:: c++
 
     class MyBuddy : public Buddy
@@ -23 +25 @@
 Subscribing to Buddy's Presence Status
 ---------------------------------------
-To subscribe to buddy's presence status, you need to add a buddy object and subscribe to buddy's presence status. The snippet below shows a sample code to achieve these::
+To subscribe to buddy's presence status, you need to add a buddy object and subscribe to buddy's presence status. The snippet below shows a sample code to achieve these:
+
+.. code-block:: c++
 
     BuddyConfig cfg;
@@ -34 +38 @@
     }
 
-Then you can get the buddy's presence state change inside the onBuddyState() callback::
+Then you can get the buddy's presence state change inside the onBuddyState() callback:
+
+.. code-block:: c++
 
     void MyBuddy::onBuddyState()
@@ -48 +54 @@
 By default, incoming presence subscription to an account will be accepted automatically. You will probably want to change this behavior, for example only to automatically accept subscription if it comes from one of the buddy in the buddy list, and for anything else prompt the user if he/she wants to accept the request.
 
-This can be done by overriding the ​onIncomingSubscribe() method of the ​Account class.
+This can be done by overriding the ​onIncomingSubscribe() method of the ​Account class. Please see the documentation of this method for more info.
 
 Changing Account's Presence Status
 ----------------------------------
-To change account's presence status, you can use the function Account.setOnlineStatus() to set basic account's presence status (i.e. available or not available) and optionally, some extended information (e.g. busy, away, on the phone, etc), such as::
+To change account's presence status, you can use the function Account.setOnlineStatus() to set basic account's presence status (i.e. available or not available) and optionally, some extended information (e.g. busy, away, on the phone, etc), such as:
+
+.. code-block:: c++
 
     try {
@@ -64 +72 @@
     }
 
-When the presence status is changed, the account will publish the new status to all of its presence subscriber, either with PUBLISH request or SUBSCRIBE request, or both, depending on account configuration.
+When the presence status is changed, the account will publish the new status to all of its presence subscriber, either with PUBLISH request or NOTIFY request, or both, depending on account configuration.
 
 Instant Messaging(IM)