mirror
/
go
mirror of https://github.com/golang/go.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

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>
This commit is contained in:
Cherry Mui 2022-11-28 18:03:20 -05:00
parent 0fd7be7ee5
commit 8c0f9ed4ce
1 changed files with 12 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
doc/go1.20.html
View File

@ -193,12 +193,12 @@ Do not send CLs removing the interior tags from such phrases.
</p> </p>
<p> <p>
The packages in the standard library that use cgo are <a href="/pkg/net/">net</a>, The packages in the standard library that use cgo are <a href="/pkg/net/"><code>net</code></a>,
<a href="/pkg/os/user/">os/user</a>, and <a href="/pkg/os/user/"><code>os/user</code></a>, and
<a href="/pkg/plugin/">plugin</a>. <a href="/pkg/plugin/"><code>plugin</code></a>.
On macOS, the net and os/user packages have been rewritten not to use cgo: 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. 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. On other systems, builds with cgo disabled will use a pure Go version of these packages.
</p> </p>
@ -297,13 +297,16 @@ Do not send CLs removing the interior tags from such phrases.
<h2 id="bootstrap">Bootstrap</h2> <h2 id="bootstrap">Bootstrap</h2>
<p><!-- https://go.dev/issue/44505 --> <p><!-- https://go.dev/issue/44505 -->
When building a Go release from source and GOROOT_BOOTSTRAP is not set, 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 $HOME/go1.4 (%HOMEDRIVE%%HOMEPATH%\go1.4 on Windows). previous versions of Go looked for a Go 1.4 or later bootstrap toolchain in the directory
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, <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. 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 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. 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 (to support systems that hard-coded the path $HOME/go1.4 but have installed
a newer Go toolchain there). a newer Go toolchain there).
In the future, we plan to move the bootstrap toolchain forward approximately once a year, In the future, we plan to move the bootstrap toolchain forward approximately once a year,