From ffd1790ba97d77a8501e96881f88fd1cafc3f330 Mon Sep 17 00:00:00 2001
From: Istvan Kiss <neon60@gmail.com>
Date: Wed, 13 Nov 2024 18:14:27 +0100
Subject: [PATCH] Add ROCm 6.3 deprecation

---
 docs/reference/deprecated_api_list.rst | 17 +++++++++++++++++
 include/hip/hip_runtime_api.h          | 16 +++++++++-------
 2 files changed, 26 insertions(+), 7 deletions(-)

diff --git a/docs/reference/deprecated_api_list.rst b/docs/reference/deprecated_api_list.rst
index a21643478c..f212a0ad34 100644
--- a/docs/reference/deprecated_api_list.rst
+++ b/docs/reference/deprecated_api_list.rst
@@ -10,6 +10,23 @@ Several of our API functions have been flagged for deprecation. Using the
 following functions results in errors and unexpected results, so we encourage
 you to update your code accordingly.
 
+Deprecated since ROCm 6.3.0
+============================================================
+
+Deprecated memory management functions.
+
+.. list-table::
+   :widths: 40, 60
+   :header-rows: 1
+   :align: left
+
+   * - function
+     -
+   * - :cpp:func:`hipHostMalloc`
+     - replaced with :cpp:func:`hipExtHostAlloc`
+   * - :cpp:func:`hipHostFree`
+     - replaced with :cpp:func:`hipFreeHost`
+
 Deprecated since ROCm 6.1.0
 ============================================================
 
diff --git a/include/hip/hip_runtime_api.h b/include/hip/hip_runtime_api.h
index 15f27da4df..52eb0a2d2a 100644
--- a/include/hip/hip_runtime_api.h
+++ b/include/hip/hip_runtime_api.h
@@ -3444,11 +3444,6 @@ hipError_t hipMallocHost(void** ptr, size_t size);
  */
 HIP_DEPRECATED("use hipHostAlloc instead")
 hipError_t hipMemAllocHost(void** ptr, size_t size);
-// end doxygen deprecated management memory
-/**
- * @}
- */
-
 /**
  *  @brief Allocates device accessible page locked (pinned) host memory
  *
@@ -3485,6 +3480,11 @@ hipError_t hipMemAllocHost(void** ptr, size_t size);
  */
 HIP_DEPRECATED("use hipExtHostAlloc instead")
 hipError_t hipHostMalloc(void** ptr, size_t size, unsigned int flags);
+// end doxygen deprecated management memory
+/**
+ * @}
+ */
+
 /**
  *  @brief Allocates device accessible page locked (pinned) host memory
  *
@@ -9643,8 +9643,8 @@ static inline hipError_t hipExtHostAlloc(T** ptr, size_t size,
     return hipExtHostAlloc((void**)ptr, size, flags);
 }
 /**
- * @brief: C++ wrapper for hipHostMalloc
- * @ingroup Memory
+ * @brief C++ wrapper for hipHostMalloc [Deprecated].
+ * @ingroup MemoryD
  * Provide an override to automatically typecast the pointer type from void**, and also provide a
  * default for the flags.
  *
@@ -9652,6 +9652,8 @@ static inline hipError_t hipExtHostAlloc(T** ptr, size_t size,
  * wrappers. It is useful for applications which need to obtain decltypes of
  * HIP runtime APIs.
  *
+ * @warning This API is deprecated.
+ * 
  * @see hipHostMalloc
  */
 template <class T>