diff --git a/doc/go1.9.html b/doc/go1.9.html
index aafd03c51f..7cee379c45 100644
--- a/doc/go1.9.html
+++ b/doc/go1.9.html
@@ -156,6 +156,21 @@ type T1 = T2
directories, write ./vendor/...
.
+ The go tool will now use the path from which it
+ was invoked to attempt to locate the root of the Go install tree.
+ This means that if the entire Go installation is moved to a new
+ location, the go tool should continue to work as usual.
+ This may be overriden by setting GOROOT
in the environment,
+ which should only be done in unusual circumstances.
+ Note that this does not affect the result of
+ the runtime.GOROOT function, which
+ will continue to report the original installation location;
+ this may be fixed in later releases.
+