summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorCherry Mui <cherryyz@google.com>2022-11-28 18:03:20 -0500
committerCherry Mui <cherryyz@google.com>2022-11-29 15:41:40 +0000
commit8c0f9ed4ce0b56c13fb1e1c52a3f48298775937e (patch)
tree57e8f1e5bf1208b811f463585d92d9ce64667829 /doc
parent0fd7be7ee5f36215b5d6b8f23f35d60bf749805a (diff)
downloadgo-git-8c0f9ed4ce0b56c13fb1e1c52a3f48298775937e.tar.gz
doc/go1.20: quote code in Bootstrap and Cgo sections
Add code tag for environment variables and file paths in the Bootstrap section. Add code tag for packages in the Cgo section. Change-Id: Ib0fad1c09fbc497a097ef43cbf5850a27b9a6532 Reviewed-on: https://go-review.googlesource.com/c/go/+/453621 Run-TryBot: Cherry Mui <cherryyz@google.com> TryBot-Result: Gopher Robot <gobot@golang.org> Reviewed-by: Ian Lance Taylor <iant@google.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/go1.20.html21
1 files changed, 12 insertions, 9 deletions
diff --git a/doc/go1.20.html b/doc/go1.20.html
index e048127ff0..d4baf103ec 100644
--- a/doc/go1.20.html
+++ b/doc/go1.20.html
@@ -193,12 +193,12 @@ Do not send CLs removing the interior tags from such phrases.
</p>
<p>
- The packages in the standard library that use cgo are <a href="/pkg/net/">net</a>,
- <a href="/pkg/os/user/">os/user</a>, and
- <a href="/pkg/plugin/">plugin</a>.
- On macOS, the net and os/user packages have been rewritten not to use cgo:
+ The packages in the standard library that use cgo are <a href="/pkg/net/"><code>net</code></a>,
+ <a href="/pkg/os/user/"><code>os/user</code></a>, and
+ <a href="/pkg/plugin/"><code>plugin</code></a>.
+ On macOS, the <code>net</code> and <code>os/user</code> packages have been rewritten not to use cgo:
the same code is now used for cgo and non-cgo builds as well as cross-compiled builds.
- On Windows, the net and os/user packages have never used cgo.
+ On Windows, the <code>net</code> and <code>os/user</code> packages have never used cgo.
On other systems, builds with cgo disabled will use a pure Go version of these packages.
</p>
@@ -297,13 +297,16 @@ Do not send CLs removing the interior tags from such phrases.
<h2 id="bootstrap">Bootstrap</h2>
<p><!-- https://go.dev/issue/44505 -->
- When building a Go release from source and GOROOT_BOOTSTRAP is not set,
- previous versions of Go looked for a Go 1.4 or later bootstrap toolchain in the directory $HOME/go1.4 (%HOMEDRIVE%%HOMEPATH%\go1.4 on Windows).
- Go 1.18 and Go 1.19 looked first for $HOME/go1.17 or $HOME/sdk/go1.17 before falling back to $HOME/go1.4,
+ When building a Go release from source and <code>GOROOT_BOOTSTRAP</code> is not set,
+ previous versions of Go looked for a Go 1.4 or later bootstrap toolchain in the directory
+ <code>$HOME/go1.4</code> (<code>%HOMEDRIVE%%HOMEPATH%\go1.4</code> on Windows).
+ Go 1.18 and Go 1.19 looked first for <code>$HOME/go1.17</code> or <code>$HOME/sdk/go1.17</code>
+ before falling back to <code>$HOME/go1.4</code>,
in ancitipation of requiring Go 1.17 for use when bootstrapping Go 1.20.
Go 1.20 does require a Go 1.17 release for bootstrapping, but we realized that we should
adopt the latest point release of the bootstrap toolchain, so it requires Go 1.17.13.
- Go 1.20 looks for $HOME/go1.17.13 or $HOME/sdk/go1.17.13 before falling back to $HOME/go1.4
+ Go 1.20 looks for <code>$HOME/go1.17.13</code> or <code>$HOME/sdk/go1.17.13</code>
+ before falling back to <code>$HOME/go1.4</code>
(to support systems that hard-coded the path $HOME/go1.4 but have installed
a newer Go toolchain there).
In the future, we plan to move the bootstrap toolchain forward approximately once a year,