[0.3.46] add desc at reference

Change-Id: I0662b89b87f060ff669b9b5eb5166f0a22cc208c

diff --git a/include/player.h b/include/player.h
index eb9f066..bc77363 100644 (file)
--- a/include/player.h
+++ b/include/player.h
@@ -96,7 +96,7 @@ typedef enum {
        PLAYER_INTERRUPTED_BY_MEDIA,                /**< Interrupted by a non-resumable media application (Deprecated since 3.0)*/
        PLAYER_INTERRUPTED_BY_CALL,                 /**< Interrupted by an incoming call (Deprecated since 3.0)*/
        PLAYER_INTERRUPTED_BY_EARJACK_UNPLUG,       /**< Interrupted by unplugging headphones (Deprecated since 3.0)*/
-       PLAYER_INTERRUPTED_BY_RESOURCE_CONFLICT,    /**< Interrupted by a resource conflict */
+       PLAYER_INTERRUPTED_BY_RESOURCE_CONFLICT,    /**< Interrupted by a resource conflict and the player handle will be unprepared */
        PLAYER_INTERRUPTED_BY_ALARM,                /**< Interrupted by an alarm (Deprecated since 3.0)*/
        PLAYER_INTERRUPTED_BY_EMERGENCY,            /**< Interrupted by an emergency (Deprecated since 3.0)*/
        PLAYER_INTERRUPTED_BY_NOTIFICATION,         /**< Interrupted by a notification (Deprecated since 3.0)*/
@@ -296,6 +296,7 @@ typedef void (*player_seek_completed_cb)(void *user_data);
 /**
  * @brief Called when the media player is interrupted.
  * @since_tizen @if WEARABLE 2.3.1 @else 2.3 @endif
+ * @details If the code is #PLAYER_INTERRUPTED_BY_RESOURCE_CONFLICT, the player handle will be unprepared.
  * @param[in]  error_code      The interrupted error code
  * @param[in]  user_data       The user data passed from the callback registration function
  * @see player_set_interrupted_cb()
@@ -796,6 +797,8 @@ int player_pause(player_h player);
  *          Please note that if application is playing external media data via player_set_media_stream_info(),
  *          then consecutive calling of this api will always success and no need to wait for player_seek_completed_cb()
  *          before next calling of this api.(since_tizen 3.0)
+ * @remarks Even if you don't set visible to true by calling player_set_display_visible,
+ *          the video will be shown when the _seek_completed cb is invoked.
  * @param[in] player The handle to the media player
  * @param[in] millisecond The position in milliseconds from the start to the seek point
  * @param[in] accurate If @c true the selected position is returned, but this might be considerably slow,