Skip to content

Commit bfa3284

Browse files
committed
doc: document WER and SEH changes in Go 1.21
While here, I've removed the CL 472195 TODO, which I marked as RELNOTE=yes by mistake. For #57441 For #57302 Change-Id: I7563140bf307f8d732f0154d02b8fa0735527323 Reviewed-on: https://go-review.googlesource.com/c/go/+/499515 Reviewed-by: Ian Lance Taylor <[email protected]> TryBot-Result: Gopher Robot <[email protected]> Reviewed-by: Michael Knyszek <[email protected]> Run-TryBot: Quim Muntal <[email protected]>
1 parent 0f91f92 commit bfa3284

File tree

1 file changed

+11
-10
lines changed

1 file changed

+11
-10
lines changed

doc/go1.21.html

Lines changed: 11 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -231,6 +231,12 @@ <h2 id="assembler">Assembler</h2>
231231

232232
<h2 id="linker">Linker</h2>
233233

234+
<p><!-- https://go.dev/issue/57302, CL 461749 -->
235+
On Windows AMD64, the linker (with help from the compiler) now emits
236+
SEH unwinding data by default, which improves the integration
237+
of Go applications with Windows debuggers and other tools.
238+
</p>
239+
234240
<!-- CL 457455 -->
235241
<p>
236242
<!-- cmd/link: generate .xdata PE section -->
@@ -745,8 +751,11 @@ <h3 id="minor_library_changes">Minor changes to the library</h3>
745751
TODO: <a href="https://go.dev/issue/38651">https://go.dev/issue/38651</a>: add &#39;created by goroutine number&#39; to stack traces
746752
</p>
747753

748-
<p><!-- https://go.dev/issue/57441 -->
749-
TODO: <a href="https://go.dev/issue/57441">https://go.dev/issue/57441</a>: use WER for GOTRACEBACK=wer on Windows
754+
<p><!-- https://go.dev/issue/57441, CL 474915 -->
755+
Crashing Go applications can now opt-in to Windows Error Reporting (WER) by setting the environment variable
756+
<code>GOTRACEBACK=wer</code> or calling <a href="/pkg/runtime/debug/#SetTraceback"><code>debug.SetTraceback("wer")</code></a>
757+
before the crash. Other than enabling WER, the runtime will behave as with <code>GOTRACEBACK=crash</code>.
758+
On non-Windows systems, <code>GOTRACEBACK=wer</code> is ignored.
750759
</p>
751760

752761
<p><!-- CL 447778 -->
@@ -758,14 +767,6 @@ <h3 id="minor_library_changes">Minor changes to the library</h3>
758767
<code>GODEBUG=cgocheck=1</code> is still available (and is still the default).
759768
</p>
760769

761-
<p><!-- CL 472195 -->
762-
TODO: <a href="https://go.dev/cl/472195">https://go.dev/cl/472195</a>: runtime: remove NOFRAME from asmcgocall, systemstack and mcall
763-
</p>
764-
765-
<p><!-- CL 474915 -->
766-
TODO: <a href="https://go.dev/cl/474915">https://go.dev/cl/474915</a>: runtime: support GOTRACEBACK=wer on Windows
767-
</p>
768-
769770
<p><!-- https://go.dev/issue/46787 -->
770771
A new type <code>Pinner</code> has been added to the runtime
771772
package. <code>Pinner</code>s may be used to "pin" Go memory

0 commit comments

Comments
 (0)