From: Sangchul Lee <sc11.lee@samsung.com>
Date: Tue, 29 Mar 2022 12:31:09 +0000 (+0900)
Subject: Revise description
X-Git-Tag: submit/tizen_6.5/20220404.065410^0
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=0f262ebe70474afef6c2146bd912e5240951c3ad;p=platform%2Fcore%2Fapi%2Fwebrtc.git

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 98ffd055..f63a3c50 100644
--- 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 766d5b57..2d0ebef2 100644
--- 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 2731847e..ef0a3120 100644
--- 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