From 12ea4f7785f27c322a657aa1ead7efc692a351dd Mon Sep 17 00:00:00 2001
From: Michael Matloob <matloob@golang.org>
Date: Wed, 12 Mar 2025 15:14:44 -0400
Subject: [PATCH] doc/next: add release note for new toolchain line behavior

The go command will now no longer update the toolchain line implicitly
to the local toolchain version when updating the go line. Document that
in a release note.

For #65847

Change-Id: I4e970d881a43c22292fe9fa65a9835d0214ef7bf
Reviewed-on: https://go-review.googlesource.com/c/go/+/657178
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
Reviewed-by: Alan Donovan <adonovan@google.com>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
---
 doc/next/3-tools.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/doc/next/3-tools.md b/doc/next/3-tools.md
index 5b52fe200d..68017c8def 100644
--- a/doc/next/3-tools.md
+++ b/doc/next/3-tools.md
@@ -10,5 +10,11 @@ These new error reports may be disabled by setting
 `ASAN_OPTIONS=detect_leaks=0` in the environment when running the
 program.
 
+<!-- go.dev/issue/65847 -->
+
+When the go command updates the `go` line in a `go.mod` or `go.work` file,
+it [no longer](/ref/mod#go-mod-file-toolchain) adds a toolchain line
+specifying the command's current version.
+
 ### Cgo {#cgo}
 
-- 
2.50.0