From bc8a1ea176c12065884271a0e0d96e47127cb461 Mon Sep 17 00:00:00 2001
From: saipraneeth <2506664+msaipraneeth@users.noreply.github.com>
Date: Wed, 28 Jan 2026 00:02:55 +0000
Subject: [PATCH] document zsh completion workaround for msys2/Windows

Add note explaining that zsh users on Windows/msys2 need to pipe
through 'tr -d \r' to strip carriage returns and avoid parse errors
when setting up command-line completion.
---
 .../configuration/completion-setup/index.md               | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/automate/cmemc-command-line-interface/configuration/completion-setup/index.md b/docs/automate/cmemc-command-line-interface/configuration/completion-setup/index.md
index 155655373..2b7dacab1 100644
--- a/docs/automate/cmemc-command-line-interface/configuration/completion-setup/index.md
+++ b/docs/automate/cmemc-command-line-interface/configuration/completion-setup/index.md
@@ -33,6 +33,14 @@ In order to enable tab completion with **zsh** run the following command:
 $ eval "$(_CMEMC_COMPLETE=zsh_source cmemc)"
 ```
 
+!!! note "Windows / msys2"
+
+    When using zsh on Windows with msys2, you need to strip carriage returns to avoid parse errors:
+
+    ``` shell-session title="completion setup for zsh on Windows/msys2"
+    $ eval "$(_CMEMC_COMPLETE=zsh_source cmemc | tr -d '\r')"
+    ```
+
 To enable the interactive menu as seen above in **zsh** run the following command:
 
 ``` shell-session title="interactive menu for zsh"