[SYCL][Graph] Adds a detail section in the comment of bith functions

Author: mfrancepillois

include/ur_api.h

@@ -8164,6 +8164,11 @@ urCommandBufferAppendMemBufferFillExp(
 ///////////////////////////////////////////////////////////////////////////////
 /// @brief Append a USM Prefetch command to a command-buffer object
 ///
+/// @details
+///     - Prefetching may not be supported for all devices or allocation types.
+///       If memory prefetching is not supported, the prefetch hint will be
+///       ignored.
+///
 /// @returns
 ///     - ::UR_RESULT_SUCCESS
 ///     - ::UR_RESULT_ERROR_UNINITIALIZED
@@ -8200,6 +8205,11 @@ urCommandBufferAppendUSMPrefetchExp(
 ///////////////////////////////////////////////////////////////////////////////
 /// @brief Append a USM Advise command to a command-buffer object
 ///
+/// @details
+///     - Not all memory advice hints may be supported for all devices or
+///       allocation types. If a memory advice hint is not supported, it will be
+///       ignored.
+///
 /// @returns
 ///     - ::UR_RESULT_SUCCESS
 ///     - ::UR_RESULT_ERROR_UNINITIALIZED

scripts/core/exp-command-buffer.yml

@@ -591,6 +591,9 @@ type: function
 desc: "Append a USM Prefetch command to a command-buffer object"
 class: $xCommandBuffer
 name: AppendUSMPrefetchExp
+details:
+    - "Prefetching may not be supported for all devices or allocation types. If memory prefetching 
+    is not supported, the prefetch hint will be ignored."
 params:
     - type: $x_exp_command_buffer_handle_t
       name: hCommandBuffer

source/loader/ur_libapi.cpp

@@ -7614,6 +7614,11 @@ ur_result_t UR_APICALL urCommandBufferAppendMemBufferFillExp(
 ///////////////////////////////////////////////////////////////////////////////
 /// @brief Append a USM Prefetch command to a command-buffer object
 ///
+/// @details
+///     - Prefetching may not be supported for all devices or allocation types.
+///       If memory prefetching is not supported, the prefetch hint will be
+///       ignored.
+///
 /// @returns
 ///     - ::UR_RESULT_SUCCESS
 ///     - ::UR_RESULT_ERROR_UNINITIALIZED
@@ -7665,6 +7670,11 @@ ur_result_t UR_APICALL urCommandBufferAppendUSMPrefetchExp(
 ///////////////////////////////////////////////////////////////////////////////
 /// @brief Append a USM Advise command to a command-buffer object
 ///
+/// @details
+///     - Not all memory advice hints may be supported for all devices or
+///       allocation types. If a memory advice hint is not supported, it will be
+///       ignored.
+///
 /// @returns
 ///     - ::UR_RESULT_SUCCESS
 ///     - ::UR_RESULT_ERROR_UNINITIALIZED

source/ur_api.cpp

@@ -6427,6 +6427,11 @@ ur_result_t UR_APICALL urCommandBufferAppendMemBufferFillExp(
 ///////////////////////////////////////////////////////////////////////////////
 /// @brief Append a USM Prefetch command to a command-buffer object
 ///
+/// @details
+///     - Prefetching may not be supported for all devices or allocation types.
+///       If memory prefetching is not supported, the prefetch hint will be
+///       ignored.
+///
 /// @returns
 ///     - ::UR_RESULT_SUCCESS
 ///     - ::UR_RESULT_ERROR_UNINITIALIZED
@@ -6469,6 +6474,11 @@ ur_result_t UR_APICALL urCommandBufferAppendUSMPrefetchExp(
 ///////////////////////////////////////////////////////////////////////////////
 /// @brief Append a USM Advise command to a command-buffer object
 ///
+/// @details
+///     - Not all memory advice hints may be supported for all devices or
+///       allocation types. If a memory advice hint is not supported, it will be
+///       ignored.
+///
 /// @returns
 ///     - ::UR_RESULT_SUCCESS
 ///     - ::UR_RESULT_ERROR_UNINITIALIZED