From c7be98c7eb5a040153f57dd02e5fec9d9086485e Mon Sep 17 00:00:00 2001
From: Luis Caro Campos <3535649+jcar87@users.noreply.github.com>
Date: Tue, 19 Mar 2024 10:45:16 +0000
Subject: [PATCH] Document CMAKE_VS_DEBUGGER_ENVIRONMENT behaviour (#3639)

---
 reference/tools/cmake/cmaketoolchain.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/reference/tools/cmake/cmaketoolchain.rst b/reference/tools/cmake/cmaketoolchain.rst
index 8197c39d6a0b..038f3e43c01e 100644
--- a/reference/tools/cmake/cmaketoolchain.rst
+++ b/reference/tools/cmake/cmaketoolchain.rst
@@ -61,6 +61,9 @@ translated from the current ``settings``:
   - Definition of the C++ standard as necessary
   - Definition of the standard library used for C++
   - Deactivation of rpaths in OSX
+  - Definition of ``CMAKE_VS_DEBUGGER_ENVIRONMENT`` when on Windows with Visual Studio.
+    This sets up the ``PATH`` environment variable to point to directories containing DLLs,
+    to allow debugging directly from the Visual Studio IDE without copying DLLs (requires CMake 3.27).
 
 - **conanvcvars.bat**: In some cases, the Visual Studio environment needs to be defined correctly for building,
   like when using the Ninja or NMake generators. If necessary, the ``CMakeToolchain`` will generate this script,