From d33eef8e6825f50394356b51ff2bbbe3d30e07e7 Mon Sep 17 00:00:00 2001 From: Ainar Garipov Date: Sat, 25 Jan 2020 00:10:36 +0300 Subject: [PATCH] gopls/doc: document updating to an unstable version Fixes golang/go#36751 Change-Id: Ib5036bcc1f8ee0ab11d9978eea597222e86cc085 Reviewed-on: https://go-review.googlesource.com/c/tools/+/216437 Reviewed-by: Rebecca Stambler Run-TryBot: Rebecca Stambler TryBot-Result: Gobot Gobot --- gopls/doc/user.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/gopls/doc/user.md b/gopls/doc/user.md index 93090e86b1..341a4d1f37 100644 --- a/gopls/doc/user.md +++ b/gopls/doc/user.md @@ -39,6 +39,19 @@ then run GO111MODULE=on go get golang.org/x/tools/gopls@latest ``` +### Unstable versions + +`go get` doesn't honor the `replace` directive in the `go.mod` of +`gopls` when you are outside of the `gopls` module, so a simple `go get` +with `@master` could fail. To actually update your `gopls` to the +latest **unstable** version, use: + +```sh +$ go get golang.org/x/tools/gopls@master golang.org/x/tools@master +``` + +In general, you should use `@latest` instead, to prevent frequent +breakages. ## Configurations