extension/CHANGELOG.md: prepare for v0.42.0
For golang/vscode-go#3453
diff --git a/extension/CHANGELOG.md b/extension/CHANGELOG.md
index 37ecf80..4aa7802 100644
--- a/extension/CHANGELOG.md
+++ b/extension/CHANGELOG.md
@@ -1,3 +1,39 @@
+## v0.42.0 - 17 Jul, 2024
+
+A comprehensive list of changes can be found in the complete [commit history](https://github.com/golang/vscode-go/compare/v0.42.0...v0.41.4).
+
+### Updates in `gopls`
+
+* Gopls v0.16: The latest Gopls version as of this release is [gopls v0.16](https://github.com/golang/tools/releases/tag/gopls%2Fv0.16.0). The extension settings documentation has been updated to align with the latest Gopls settings.
+* The gopls project provides an index of [all supported features](https://github.com/golang/tools/tree/master/gopls/doc/features). We are working on making this documentation more accessible from the extension. Please stay tuned for updates.
+
+### Updates in telemetry
+
+Like other Go toolchains, this extension continues to use Go Telemetry. We have enhanced the [Go Telemetry documentation](https://go.dev/doc/telemetry). By default, telemetry data is kept only on the local computer, but you can opt in to share it with the Go team with one of the following ways:
+
+- `go run golang.org/x/telemetry/cmd/gotelemetry@latest on` in the terminal, or
+- `go telemetry on`, from go1.23, or
+- Respond to the prompt when it appears.
+
+Once uploading is enabled, the data will be sent to https://telemetry.go.dev each week.
+
+### Changes
+
+#### Tools installation
+
+* For tools installation managed by the extension, this version requires go1.19 or a newer version. The next minor release (v0.43.0+) will require go1.21 or newer. You can still manually install the required tools or use the [`"go.toolsManagement.go"` setting](https://github.com/golang/vscode-go/wiki/settings#gotoolsmanagementgo) to make the extension use a newer Go version than your project's go version. However, we strongly encourage upgrading to the [officially supported go versions](https://go.dev/doc/devel/release#policy) to receive security updates and bug fixes.
+
+* The extension installs its required tools using the `go install` command. Starting go1.21, the `go` command allows tool authors to specify the minimum Go version required to build their tools. If the required go toolchain version is not locally available, the `go` command needs to download it like other dependencies of the tool. To ensure this toolchain switch works correctly, the extension enforces `GOTOOLCHAIN=auto` mode during tools installation. Note that this change does not affect how it builds and tests your own project. For more information about Go's toolchain switch behavior, see the [official documentation](https://go.dev/doc/toolchain).
+
+#### Debugging
+
+* The default launch.json template for "Go: Launch Package" was updated to use `"${workspaceFolder}${1:}"` instead of `"${fileDirname}"` as the default `"program"` attribute value. If the package to debug is located in the subdirectory, adjust the configuration to point to the main package path. The [official VS Code Variables Reference](https://code.visualstudio.com/docs/editor/variables-reference) lists useful substitution rules you can use in adjusting your launch.json setting.
+
+### Thanks
+
+Thanks for your contributions, @yimiaoxiehou!
+
+
## v0.41.4 - 24 Apr, 2024
This point release addresses a regression issue (spurious display of the Go welcome page) within cloud-based IDEs.
| Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. |
Kokoro presubmit build finished with status: SUCCESS
Logs at: https://source.cloud.google.com/results/invocations/8acb4512-dd89-43ea-b769-42c029edba47
| kokoro-CI | +1 |
| Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. |
Like other Go toolchains, this extension continues to use Go Telemetry. We have enhanced the [Go Telemetry documentation](https://go.dev/doc/telemetry). By default, telemetry data is kept only on the local computer, but you can opt in to share it with the Go team with one of the following ways:I don't understand this sentence -- what other Go toolchains are there?
I suggest simplifying the first two sentences to:
```
This extension continues to use [Go toolchain telemetry](https://go.dev/doc/telemetry).
```
Once uploading is enabled, the data will be sent to https://telemetry.go.dev each week.s/each week/approximately once a week
* For tools installation managed by the extension, this version requires go1.19 or a newer version. The next minor release (v0.43.0+) will require go1.21 or newer. You can still manually install the required tools or use the [`"go.toolsManagement.go"` setting](https://github.com/golang/vscode-go/wiki/settings#gotoolsmanagementgo) to make the extension use a newer Go version than your project's go version. However, we strongly encourage upgrading to the [officially supported go versions](https://go.dev/doc/devel/release#policy) to receive security updates and bug fixes.I'm a little confused by this sentence. The previous sentence mentions upgrading to a newer Go version, and then this sentence starts "However, we strongly encourage upgrading...", as if the previous sentence was about using older Go versions.
| Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. |
| Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. |
| Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. |
Like other Go toolchains, this extension continues to use Go Telemetry. We have enhanced the [Go Telemetry documentation](https://go.dev/doc/telemetry). By default, telemetry data is kept only on the local computer, but you can opt in to share it with the Go team with one of the following ways:I don't understand this sentence -- what other Go toolchains are there?
I suggest simplifying the first two sentences to:
```
This extension continues to use [Go toolchain telemetry](https://go.dev/doc/telemetry).
```
Done
Once uploading is enabled, the data will be sent to https://telemetry.go.dev each week.s/each week/approximately once a week
Done
* For tools installation managed by the extension, this version requires go1.19 or a newer version. The next minor release (v0.43.0+) will require go1.21 or newer. You can still manually install the required tools or use the [`"go.toolsManagement.go"` setting](https://github.com/golang/vscode-go/wiki/settings#gotoolsmanagementgo) to make the extension use a newer Go version than your project's go version. However, we strongly encourage upgrading to the [officially supported go versions](https://go.dev/doc/devel/release#policy) to receive security updates and bug fixes.I'm a little confused by this sentence. The previous sentence mentions upgrading to a newer Go version, and then this sentence starts "However, we strongly encourage upgrading...", as if the previous sentence was about using older Go versions.
| Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. |
| Code-Review | +2 |
* Gopls v0.16: The latest Gopls version as of this release is [gopls v0.16](https://github.com/golang/tools/releases/tag/gopls%2Fv0.16.0). The extension settings documentation has been updated to align with the latest Gopls settings.s/Gopls/gopls, whenever it not the start of a sentence.
* For tools installation managed by the extension, this version requires go1.19 or a newer version. The next minor release (v0.43.0+) will require go1.21 or newer. You can still manually install the required tools or use the [`"go.toolsManagement.go"` setting](https://github.com/golang/vscode-go/wiki/settings#gotoolsmanagementgo) to make the extension use a newer Go version than your project's go version. However, we strongly encourage upgrading to the [officially supported go versions](https://go.dev/doc/devel/release#policy) to receive security updates and bug fixes.Hyang-Ah Hana KimI'm a little confused by this sentence. The previous sentence mentions upgrading to a newer Go version, and then this sentence starts "However, we strongly encourage upgrading...", as if the previous sentence was about using older Go versions.
PTAL.
Much clearer, thanks.
* For tools installation managed by the extension, this version requires go1.19 or a newer version. The next minor release (v0.43.0+) will require go1.21 or newer to install tools. If your project requires go1.20 or older to build, you will need to manually install [compatible versions of tools](https://github.com/golang/vscode-go/wiki/tools), or configure the [`"go.toolsManagement.go"` setting](https://github.com/golang/vscode-go/wiki/settings#gotoolsmanagementgo) to use go1.21+ when installing the tools.go1.19 or newer
| Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. |
| Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. |
Kokoro presubmit build finished with status: SUCCESS
| Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. |
| Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. |
| Auto-Submit | +1 |
* Gopls v0.16: The latest Gopls version as of this release is [gopls v0.16](https://github.com/golang/tools/releases/tag/gopls%2Fv0.16.0). The extension settings documentation has been updated to align with the latest Gopls settings.s/Gopls/gopls, whenever it not the start of a sentence.
Thanks. Done.
* For tools installation managed by the extension, this version requires go1.19 or a newer version. The next minor release (v0.43.0+) will require go1.21 or newer to install tools. If your project requires go1.20 or older to build, you will need to manually install [compatible versions of tools](https://github.com/golang/vscode-go/wiki/tools), or configure the [`"go.toolsManagement.go"` setting](https://github.com/golang/vscode-go/wiki/settings#gotoolsmanagementgo) to use go1.21+ when installing the tools.Hyang-Ah Hana Kimgo1.19 or newer
Done
| Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. |
Kokoro presubmit build finished with status: SUCCESS
| Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. |
Kokoro presubmit build finished with status: SUCCESS
| Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. |
Kokoro presubmit build finished with status: SUCCESS
| Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. |
3 is the latest approved patch-set.
The change was submitted with unreviewed changes in the following files:
```
The name of the file: extension/CHANGELOG.md
Insertions: 3, Deletions: 3.
@@ -4,7 +4,7 @@
### Updates in `gopls`
-* Gopls v0.16: The latest Gopls version as of this release is [gopls v0.16](https://github.com/golang/tools/releases/tag/gopls%2Fv0.16.0). The extension settings documentation has been updated to align with the latest Gopls settings.
+* Gopls v0.16: The latest gopls version as of this release is [gopls v0.16](https://github.com/golang/tools/releases/tag/gopls%2Fv0.16.0). The extension settings documentation has been updated to align with the latest gopls settings.
* The gopls project provides an index of [all supported features](https://github.com/golang/tools/tree/master/gopls/doc/features). We are working on making this documentation more accessible from the extension. Please stay tuned for updates.
### Updates in telemetry
@@ -22,7 +22,7 @@
#### Tools installation
-* For tools installation managed by the extension, this version requires go1.19 or a newer version. The next minor release (v0.43.0+) will require go1.21 or newer to install tools. If your project requires go1.20 or older to build, you will need to manually install [compatible versions of tools](https://github.com/golang/vscode-go/wiki/tools), or configure the [`"go.toolsManagement.go"` setting](https://github.com/golang/vscode-go/wiki/settings#gotoolsmanagementgo) to use go1.21+ when installing the tools.
+* For tools installation managed by the extension, this version requires go1.19 or newer version. The next minor release (v0.43.0+) will require go1.21 or newer to install tools. If your project requires go1.20 or older to build, you will need to manually install [compatible versions of tools](https://github.com/golang/vscode-go/wiki/tools), or configure the [`"go.toolsManagement.go"` setting](https://github.com/golang/vscode-go/wiki/settings#gotoolsmanagementgo) to use go1.21+ when installing the tools.
* The extension installs its required tools using the `go install` command. Starting go1.21, the `go` command allows tool authors to specify the minimum Go version required to build their tools. If the required go toolchain version is not locally available, the `go` command needs to download it like other dependencies of the tool. To ensure this toolchain switch works correctly, the extension enforces `GOTOOLCHAIN=auto` mode during tools installation. Note that this change does not affect how it builds and tests your own project. For more information about Go's toolchain switch behavior, see the [official documentation](https://go.dev/doc/toolchain).
@@ -503,7 +503,7 @@
* Activation: the extension defers commands and feature provider registrations until it runs `go version` and `go env`, and starts `gopls`. [This change](https://go-review.googlesource.com/c/vscode-go/+/398155) prevent the extension prematually export its features, but may result in a slight increase in extension activation time if those commands run slow.
-* Survey: we show the Gopls opt-out survey prompt only when users change the setting to disable `gopls`.
+* Survey: we show the gopls opt-out survey prompt only when users change the setting to disable `gopls`.
* Test Explorer: fixed a bug in `go.mod` file parsing ([Issue 2171](https://github.com/golang/vscode-go/issues/2171))
```
extension/CHANGELOG.md: prepare for v0.42.0
For golang/vscode-go#3453
| Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. |