From e872807e2b7d74ba4ac474e697027a9318439d04 Mon Sep 17 00:00:00 2001
From: qmuntal <quimmuntal@gmail.com>
Date: Sat, 9 Dec 2023 01:03:32 +0100
Subject: [PATCH] doc: document SEH changes

For #57302.
For #61422.

Change-Id: Iee4e6600bf473eb982d0cb7330f7b2c1b48b9e13
Reviewed-on: https://go-review.googlesource.com/c/go/+/548575
Reviewed-by: Cherry Mui <cherryyz@google.com>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Reviewed-by: Than McIntosh <thanm@google.com>
Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
---
 doc/go1.22.html | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/doc/go1.22.html b/doc/go1.22.html
index f21c774ef13777..3c67dee3bb52f4 100644
--- a/doc/go1.22.html
+++ b/doc/go1.22.html
@@ -239,6 +239,17 @@ <h2 id="linker">Linker</h2>
   build ID.
 </p>
 
+<p><!-- CL 534555 -->
+  On Windows, when building with <code>-linkmode=internal</code>, the linker now
+  preserves SEH information from C object files by copying the <code>.pdata</code>
+  and <code>.xdata</code> sections into the final binary.
+  This helps with debugging and profiling binaries using native tools, such as WinDbg.
+  Note that until now, C functions' SEH exception handlers were not being honored,
+  so this change may cause some programs to behave differently.
+  <code>-linkmode=external</code> is not affected by this change, as external linkers
+  already preserve SEH information.
+</p>
+
 <h2 id="bootstrap">Bootstrap</h2>
 
 <p>