Revise description

webrtc_doc.h
 - Fix invalid information

webrtc.h
 - Add @remarks to callback function prototypes

[Version] 0.2.165
[Issue Type] Doxygen

Change-Id: Iac7524e8fcee20341a147d1c8eaefb58cfec1035
Signed-off-by: Sangchul Lee <sc11.lee@samsung.com>

diff --git a/doc/webrtc_doc.h b/doc/webrtc_doc.h
index 98ffd05522fe2fc3e0fd4bc59a01b07224bdc9c2..f63a3c50dca48f181e5c17ec2edebe479b1ae64f 100644 (file)
--- a/doc/webrtc_doc.h
+++ b/doc/webrtc_doc.h
@@ -75,7 +75,7 @@
  *    <td> webrtc_stop() </td>
  *    <td> NEGOTIATING/PLAYING </td>
  *    <td> IDLE </td>
- *    <td> SYNC </td>
+ *    <td> ASYNC </td>
  * </tr>
  * <tr>
  *    <td> webrtc_set_remote_description() </td>

diff --git a/include/webrtc.h b/include/webrtc.h
index 766d5b57d767f84300087568b19e5f74c76a46ca..2d0ebef204c6a3097b0af5e3114574e2d85157e3 100644 (file)
--- a/include/webrtc.h
+++ b/include/webrtc.h
@@ -303,7 +303,8 @@ typedef void (*webrtc_state_changed_cb)(webrtc_h webrtc, webrtc_state_e previous
  * @remarks The @a webrtc is the same object for which the callback was set.\n
  *          The @a webrtc should not be released.\n
  *          @a description is a JSON string.\n
- *          It will be {"sdp":{"type":"offer or answer","sdp":"..."}}.
+ *          It will be {"sdp":{"type":"offer or answer","sdp":"..."}}.\n
+ *          The @a description can be used only in the callback. To use outside, make a copy.
  * @param[in] webrtc       WebRTC handle
  * @param[in] description  The session description
  * @param[in] user_data    The user data passed from the callback registration function
@@ -370,6 +371,7 @@ typedef void (*webrtc_ice_connection_state_change_cb)(webrtc_h webrtc, webrtc_ic
 /**
  * @brief Called iteratively to inform all the TURN server URLs.
  * @since_tizen 6.5
+ * @remarks The @a turn_server can be used only in the callback. To use outside, make a copy.
  * @param[in] turn_server  The TURN server URL
  * @param[in] user_data    The user data passed from the callback registration function
  * @return @c true to continue with the next iteration of the loop,
@@ -394,7 +396,8 @@ typedef void (*webrtc_negotiation_needed_cb)(webrtc_h webrtc, void *user_data);
  * @brief Called when the WebRTC needs to send the ICE candidate message to the remote peer through the signaling channel.
  * @since_tizen 6.5
  * @remarks The @a webrtc is the same object for which the callback was set.\n
- *          The @a webrtc should not be released.
+ *          The @a webrtc should not be released.\n
+ *          The @a candidate can be used only in the callback. To use outside, make a copy.
  * @param[in] webrtc     WebRTC handle
  * @param[in] candidate  The ICE candidate message
  * @param[in] user_data  The user data passed from the callback registration function

diff --git a/packaging/capi-media-webrtc.spec b/packaging/capi-media-webrtc.spec
index 2731847e4730643685b556d3f803b2817222cbfc..ef0a312015a87d870325de1e97860a3e789af9ac 100644 (file)
--- a/packaging/capi-media-webrtc.spec
+++ b/packaging/capi-media-webrtc.spec
@@ -1,6 +1,6 @@
 Name:       capi-media-webrtc
 Summary:    A WebRTC library in Tizen Native API
-Version:    0.2.164
+Version:    0.2.165
 Release:    0
 Group:      Multimedia/API
 License:    Apache-2.0