Skip to content

Commit a852b25

Browse files
committed
gopls/doc/release: update gopls release notes for language support
Update the v0.16.0 release notes to reflect 1.23 support and changes to our support policy. For golang/go#67936 Change-Id: I330b8a3897fc3b4b944eb695143042654556dbf1 Reviewed-on: https://go-review.googlesource.com/c/tools/+/592156 LUCI-TryBot-Result: Go LUCI <[email protected]> Reviewed-by: Alan Donovan <[email protected]>
1 parent 03d7125 commit a852b25

File tree

2 files changed

+39
-4
lines changed

2 files changed

+39
-4
lines changed

gopls/README.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -85,8 +85,8 @@ gopls build will depend on the latest version of Go. However, due to the
8585
[forward compatibility](https://go.dev/blog/toolchain) support added to the
8686
`go` command in Go 1.21, as long as Go 1.21 or later are used to install gopls,
8787
the toolchain upgrade will be handled automatically, just like any other
88-
dependency. Gopls will continue to support integrating with the two most recent
89-
major Go releases of the `go` command, per the Go Release Policy. See
88+
dependency. Gopls will continue to support integrating with the three most
89+
recent major Go releases of the `go` command. See
9090
[issue #65917](https://go.dev/issue/65917) for more details.
9191

9292
Maintaining support for legacy versions of Go caused

gopls/doc/release/v0.16.0.md

+37-2
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,35 @@
1-
gopls/v0.16.0
1+
# gopls/v0.16.0
22

3+
<!-- TODO: update this instruction once v0.16.0 is released -->
34
```
4-
go install golang.org/x/tools/[email protected]
5+
go install golang.org/x/tools/[email protected]-pre.1
56
```
67

8+
This release includes several features and bug fixes, and is the first
9+
version of gopls to support Go 1.23. To install it, run:
10+
11+
## New support policy; end of support for Go 1.19 and Go 1.20
12+
13+
This is the last release of gopls that may be built and used with Go 1.19 or Go
14+
1.20. If built or used with either of these Go versions, it will display
15+
a message advising the user to upgrade.
16+
17+
Starting with [email protected], which will be released after Go 1.23.0 is released
18+
in August, installing gopls will require the latest version of the Go
19+
toolchain. Thanks to the [forward compatibility](https://go.dev/blog/toolchain)
20+
added to Go 1.21, any necessary toolchain upgrade should be handled
21+
automatically for users of Go 1.21 or later. This restriction is for _building_
22+
gopls only -- we will continue to support command line integration with the
23+
last three major Go versions. Nonetheless, this is fewer than our previous policy
24+
of gopls supporting the last four major Go versions of installed toolchains.
25+
26+
See the newly updated
27+
[support policy](https://github.com/golang/tools/tree/master/gopls#support-policy)
28+
for details. We expect that this change will significantly reduce our
29+
maintenance burden, and will help improve the stability of future gopls
30+
releases. Please comment on [issue #65917](https://go.dev/issue/65917) if you
31+
have concerns about this change.
32+
733
## Configuration Changes
834

935
- The experimental "allowImplicitNetworkAccess" setting is deprecated (but not
@@ -12,6 +38,15 @@ go install golang.org/x/tools/[email protected]
1238

1339
## New features
1440

41+
### Go 1.23 support
42+
43+
This version of gopls is the first to support new Go 1.23 language features,
44+
including
45+
[range-over-func](https://go.dev/wiki/RangefuncExperiment) iterators
46+
and support for the
47+
[`godebug` directive](https://go.dev/ref/mod#go-mod-file-godebug)
48+
in go.mod files.
49+
1550
### Integrated documentation viewer
1651

1752
Gopls now offers a "View package documentation" code action that opens

0 commit comments

Comments
 (0)