From 42c085ddd8863234a7b170c27ce5fe504a375cf4 Mon Sep 17 00:00:00 2001 From: Francisco Herrera Date: Sat, 13 Dec 2025 13:05:54 -0500 Subject: [PATCH 1/7] Clarify setup steps for Linux Added note that setup steps apply to Linux as well. --- docs/backend/OPENCL.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/backend/OPENCL.md b/docs/backend/OPENCL.md index e52baffdff..4ba87218fe 100644 --- a/docs/backend/OPENCL.md +++ b/docs/backend/OPENCL.md @@ -174,6 +174,8 @@ If an older version of Powershell is used, these commands may not work as they a ### I. Setup Environment +The two steps below also apply to Linux. + 1. **Install OpenCL Headers and Library** ```powershell From 7baf8aa2d1a385bd48e0c198d88150163b6bad7e Mon Sep 17 00:00:00 2001 From: Francisco Herrera Date: Sat, 13 Dec 2025 22:55:23 -0500 Subject: [PATCH 2/7] Added note for backtick replacement --- docs/backend/OPENCL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/backend/OPENCL.md b/docs/backend/OPENCL.md index 4ba87218fe..11293a7da5 100644 --- a/docs/backend/OPENCL.md +++ b/docs/backend/OPENCL.md @@ -174,7 +174,7 @@ If an older version of Powershell is used, these commands may not work as they a ### I. Setup Environment -The two steps below also apply to Linux. +The two steps below also apply to Linux. Simply replace the backticks with back slashes. Ensure you have Git, CMake, Clang, Ninja and Python installed. 1. **Install OpenCL Headers and Library** From 011a2f68ddd375ac370812d08a8e4266dc118386 Mon Sep 17 00:00:00 2001 From: Francisco Herrera Date: Sat, 13 Dec 2025 22:59:33 -0500 Subject: [PATCH 3/7] clarify that backtick replacement only applies on linux --- docs/backend/OPENCL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/backend/OPENCL.md b/docs/backend/OPENCL.md index 11293a7da5..ae50517332 100644 --- a/docs/backend/OPENCL.md +++ b/docs/backend/OPENCL.md @@ -174,7 +174,7 @@ If an older version of Powershell is used, these commands may not work as they a ### I. Setup Environment -The two steps below also apply to Linux. Simply replace the backticks with back slashes. Ensure you have Git, CMake, Clang, Ninja and Python installed. +The two steps below also apply to Linux. If building for Linux, simply replace the backticks with back slashes. Ensure you have Git, CMake, Clang, Ninja and Python installed. 1. **Install OpenCL Headers and Library** From 7e5391d26a0eea75ff8f00dc2149746f795fb251 Mon Sep 17 00:00:00 2001 From: Francisco Herrera Date: Sat, 13 Dec 2025 23:42:50 -0500 Subject: [PATCH 4/7] clarified Linux specific steps So actually some changes are needed for Linux but they are minor. --- docs/backend/OPENCL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/backend/OPENCL.md b/docs/backend/OPENCL.md index ae50517332..fc92ef9830 100644 --- a/docs/backend/OPENCL.md +++ b/docs/backend/OPENCL.md @@ -174,7 +174,7 @@ If an older version of Powershell is used, these commands may not work as they a ### I. Setup Environment -The two steps below also apply to Linux. If building for Linux, simply replace the backticks with back slashes. Ensure you have Git, CMake, Clang, Ninja and Python installed. +The two steps below also apply to Linux. If building for Linux, Ensure you have Git, CMake, Clang, Ninja and Python installed, in the second step remove the `-DCMAKE_TOOLCHAIN_FILE` parameter, and replace the backticks with back slashes. 1. **Install OpenCL Headers and Library** From 836d49facd0243a6140ea796a2e485337f28cb36 Mon Sep 17 00:00:00 2001 From: Francisco Herrera Date: Sun, 14 Dec 2025 00:06:28 -0500 Subject: [PATCH 5/7] clarify change execution --- docs/backend/OPENCL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/backend/OPENCL.md b/docs/backend/OPENCL.md index fc92ef9830..b59d2aab24 100644 --- a/docs/backend/OPENCL.md +++ b/docs/backend/OPENCL.md @@ -174,7 +174,7 @@ If an older version of Powershell is used, these commands may not work as they a ### I. Setup Environment -The two steps below also apply to Linux. If building for Linux, Ensure you have Git, CMake, Clang, Ninja and Python installed, in the second step remove the `-DCMAKE_TOOLCHAIN_FILE` parameter, and replace the backticks with back slashes. +The two steps below also apply to Linux. If building for Linux, Ensure you have Git, CMake, Clang, Ninja and Python installed, in the second step remove the `-DCMAKE_TOOLCHAIN_FILE` parameter, and then in both steps replace the backticks with back slashes. 1. **Install OpenCL Headers and Library** From 95d833257920ce0d7117c3abd13872562473c10b Mon Sep 17 00:00:00 2001 From: Francisco Herrera Date: Sun, 14 Dec 2025 09:42:36 -0500 Subject: [PATCH 6/7] clarify by placing info after steps --- docs/backend/OPENCL.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/backend/OPENCL.md b/docs/backend/OPENCL.md index b59d2aab24..acac5b19b2 100644 --- a/docs/backend/OPENCL.md +++ b/docs/backend/OPENCL.md @@ -174,8 +174,6 @@ If an older version of Powershell is used, these commands may not work as they a ### I. Setup Environment -The two steps below also apply to Linux. If building for Linux, Ensure you have Git, CMake, Clang, Ninja and Python installed, in the second step remove the `-DCMAKE_TOOLCHAIN_FILE` parameter, and then in both steps replace the backticks with back slashes. - 1. **Install OpenCL Headers and Library** ```powershell @@ -220,6 +218,10 @@ cmake .. -G Ninja ` ninja ``` +## Linux + +The two steps below also apply to Linux. If building for Linux, Ensure you have Git, CMake, Clang, Ninja and Python installed, in the second step remove the `-DCMAKE_TOOLCHAIN_FILE` parameter, and then in both steps replace the backticks with back slashes. + ## Known Issues - Flash attention does not always improve performance. From a78708415583cee7b41561ba6bb485945dc2d59a Mon Sep 17 00:00:00 2001 From: Francisco Herrera Date: Sun, 14 Dec 2025 09:43:25 -0500 Subject: [PATCH 7/7] clarify which steps --- docs/backend/OPENCL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/backend/OPENCL.md b/docs/backend/OPENCL.md index acac5b19b2..f25d641b4d 100644 --- a/docs/backend/OPENCL.md +++ b/docs/backend/OPENCL.md @@ -220,7 +220,7 @@ ninja ## Linux -The two steps below also apply to Linux. If building for Linux, Ensure you have Git, CMake, Clang, Ninja and Python installed, in the second step remove the `-DCMAKE_TOOLCHAIN_FILE` parameter, and then in both steps replace the backticks with back slashes. +The two steps just above also apply to Linux. If building for Linux, Ensure you have Git, CMake, Clang, Ninja and Python installed, in the second step remove the `-DCMAKE_TOOLCHAIN_FILE` parameter, and then in both steps replace the backticks with back slashes. ## Known Issues