From 3aa1aefe3dad09f6785fdffb34779af7cba5fc41 Mon Sep 17 00:00:00 2001
From: Alex Xu <alex.xu@amd.com>
Date: Tue, 8 Oct 2024 10:22:33 -0400
Subject: [PATCH] SWDEV-489441 - Add a note to __constant__ docs

We observed community user attempting to add __constant__ to template, which is considered as bad practice. Adding a note to address it.

Change-Id: I8aaede26e4e29bf450374e74ef79c033d4f1432b


[ROCm/hip commit: c5e11fcac8249ce4f7e70157588ff9661a870b59]
---
 projects/hip/docs/reference/kernel_language.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/projects/hip/docs/reference/kernel_language.rst b/projects/hip/docs/reference/kernel_language.rst
index eb23a78ed8..480eeb4e37 100644
--- a/projects/hip/docs/reference/kernel_language.rst
+++ b/projects/hip/docs/reference/kernel_language.rst
@@ -174,6 +174,10 @@ while the kernel is running. The functions for accessing constant memory are:
 * ``hipMemcpyFromSymbol()``
 * ``hipMemcpyFromSymbolAsync()``
 
+.. note::
+
+  Add ``__constant__`` to a template can lead to undefined behavior. Refer to `HIP Issue #3201 <https://github.com/ROCm/HIP/issues/3201>`_ for details.
+
 .. _shared-variable-type:
 
 ``__shared__``