From 52462d29c975828ce9dcf61aaa9d056e749635b5 Mon Sep 17 00:00:00 2001
From: Geoffrey McRae <geoff@hostfission.com>
Date: Sat, 3 Oct 2026 08:47:41 +1000
Subject: [PATCH] [client] windows: document PowerShell policy override

---
 doc/build_client_windows.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/doc/build_client_windows.rst b/doc/build_client_windows.rst
index e5cba88b..c6ae67e4 100644
--- a/doc/build_client_windows.rst
+++ b/doc/build_client_windows.rst
@@ -32,10 +32,12 @@ Building
 
 Open an x64 Native Tools command prompt. Alternatively, initialize a regular
 PowerShell session for an x64 host and target first (replace ``Community``
-with the installed Visual Studio edition when necessary):
+with the installed Visual Studio edition when necessary). The process-scoped
+policy change below applies only to the current PowerShell session:
 
 .. code:: powershell
 
+   Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force
    $vsTools = 'C:\Program Files\Microsoft Visual Studio\2022\Community\Common7\Tools'
    & "$vsTools\Launch-VsDevShell.ps1" `
      -Arch amd64 -HostArch amd64 -SkipAutomaticLocation