From 7cab1b1b26e49512a1ae56916ee39a6cc10dab46 Mon Sep 17 00:00:00 2001 From: Robert Griesemer Date: Tue, 2 Dec 2025 11:58:29 -0800 Subject: [PATCH] doc: pre-announce removal of gotypesalias and asynctimerchan GODEBUG flags This announcement follows the policy outlined in #76163. For #76472. Change-Id: I4299e7f474e314810883dc4f50be6afba8c3e3e7 Reviewed-on: https://go-review.googlesource.com/c/go/+/726020 Auto-Submit: Robert Griesemer Reviewed-by: Alan Donovan Reviewed-by: Robert Griesemer LUCI-TryBot-Result: Go LUCI --- doc/godebug.md | 4 ++-- doc/next/6-stdlib/99-minor/go/types/76472.md | 4 ++++ doc/next/6-stdlib/99-minor/time/76472.md | 5 +++++ 3 files changed, 11 insertions(+), 2 deletions(-) create mode 100644 doc/next/6-stdlib/99-minor/go/types/76472.md create mode 100644 doc/next/6-stdlib/99-minor/time/76472.md diff --git a/doc/godebug.md b/doc/godebug.md index d6bb18603c..28a2dc506e 100644 --- a/doc/godebug.md +++ b/doc/godebug.md @@ -306,7 +306,7 @@ Go 1.23 changed the channels created by package time to be unbuffered and [`Timer.Reset`](/pkg/time/#Timer.Reset) method results much easier. The [`asynctimerchan` setting](/pkg/time/#NewTimer) disables this change. There are no runtime metrics for this change, -This setting may be removed in a future release, Go 1.27 at the earliest. +This setting will be removed in Go 1.27. Go 1.23 changed the mode bits reported by [`os.Lstat`](/pkg/os#Lstat) and [`os.Stat`](/pkg/os#Stat) for reparse points, which can be controlled with the `winsymlink` setting. @@ -385,7 +385,7 @@ Whether the type checker produces `Alias` types or not is controlled by the [`gotypesalias` setting](/pkg/go/types#Alias). For Go 1.22 it defaults to `gotypesalias=0`. For Go 1.23, `gotypesalias=1` will become the default. -This setting will be removed in a future release, Go 1.27 at the earliest. +This setting will be removed in Go 1.27. Go 1.22 changed the default minimum TLS version supported by both servers and clients to TLS 1.2. The default can be reverted to TLS 1.0 using the diff --git a/doc/next/6-stdlib/99-minor/go/types/76472.md b/doc/next/6-stdlib/99-minor/go/types/76472.md new file mode 100644 index 0000000000..f9c884b60a --- /dev/null +++ b/doc/next/6-stdlib/99-minor/go/types/76472.md @@ -0,0 +1,4 @@ +The `asynctimerchan` GODEBUG setting introduced in [Go 1.23](/doc/godebug#go-123) +will be removed in the next major Go release. +Starting in Go 1.27, the [time](/pkg/time) package will always use unbuffered +(synchronous) channels for timers regardless of GODEBUG setting or go.mod language version. diff --git a/doc/next/6-stdlib/99-minor/time/76472.md b/doc/next/6-stdlib/99-minor/time/76472.md new file mode 100644 index 0000000000..bddca82c4b --- /dev/null +++ b/doc/next/6-stdlib/99-minor/time/76472.md @@ -0,0 +1,5 @@ +The `gotypesalias` GODEBUG setting introduced in [Go 1.22](/doc/godebug#go-122) +will be removed in the next major Go release. +Starting in Go 1.27, the [go/types](/pkg/go/types) package will always produce an +[Alias type](/pkg/go/types#Alias) for the representation of [type aliases](/ref/spec#Type_declarations) +regardless of GODEBUG setting or go.mod language version. -- 2.52.0