From: qmuntal <quimmuntal@gmail.com>
Date: Sat, 9 Dec 2023 00:03:32 +0000 (+0100)
Subject: doc: document SEH changes
X-Git-Tag: go1.22rc1~41
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=e872807e2b7d74ba4ac474e697027a9318439d04;p=gostls13.git

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>
---

diff --git a/doc/go1.22.html b/doc/go1.22.html
index f21c774ef1..3c67dee3bb 100644
--- a/doc/go1.22.html
+++ b/doc/go1.22.html
@@ -239,6 +239,17 @@ defer func() {
   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>