From beec3faeeec42058e6685bdd650eeba04cef6cea Mon Sep 17 00:00:00 2001
From: Brad King <brad.king@kitware.com>
Date: Mon, 14 Sep 2026 13:51:52 -0400
Subject: [PATCH] Help: Add note to avoid trailing backslashes in paths passed
 via `cmake -D`

Closes: #28089
---
 Help/manual/include/OPTIONS_BUILD.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/Help/manual/include/OPTIONS_BUILD.rst b/Help/manual/include/OPTIONS_BUILD.rst
index 213586c29b..ae283a0a96 100644
--- a/Help/manual/include/OPTIONS_BUILD.rst
+++ b/Help/manual/include/OPTIONS_BUILD.rst
@@ -74,6 +74,12 @@
  precedence regardless of order because of the nature of non-``FORCE``
  ``set(... CACHE ...)`` calls.
 
+ .. note::
+
+   When passing a :ref:`semicolon-separated list <CMake Language Lists>`
+   of paths on Windows, avoid paths with a trailing ``\``, as it may
+   escape the following ``;`` during list expansion.
+
 .. option:: -U <globbing_expr>
 
  Remove matching entries from CMake ``CACHE``.