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/20220404.065455~1
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=07e6462be1028f63484db2a2eabed18eceb45b15;p=platform%2Fcore%2Fapi%2Fwebrtc.git

Revise description

webrtc_doc.h
 - Fix invalid information

webrtc.h
 - Add @remarks to callback function prototypes

[Version] 0.3.79
[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 60f080b5..06d348d6 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 dbf3f1de..aeece6b4 100644
--- a/include/webrtc.h
+++ b/include/webrtc.h
@@ -488,7 +488,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
@@ -555,6 +556,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,
@@ -579,7 +581,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
@@ -775,6 +778,7 @@ typedef void (*webrtc_data_channel_buffered_amount_low_cb)(webrtc_data_channel_h
 /**
  * @brief Called iteratively to inform about a statistics property.
  * @since_tizen 7.0
+ * @remarks The @a prop_info can be used only in the callback. To use outside, make a copy.
  * @param[in] type       The statistics type
  * @param[in] prop_info  The statistics property information
  * @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 cbed9abd..504bc4e3 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.3.78
+Version:    0.3.79
 Release:    0
 Group:      Multimedia/API
 License:    Apache-2.0