aboutsummaryrefslogtreecommitdiff
path: root/doc/install-source.html
AgeCommit message (Collapse)Author
2021-02-16doc: remove install.html and install-source.htmlRuss Cox
These live in x/website/content/doc now. The copies here just attract edits that have no actual effect. For #40496. For #41861. Change-Id: I2fdd7375e373949eb9a88f4cdca440b6a5d45eea Reviewed-on: https://go-review.googlesource.com/c/go/+/291709 Trust: Russ Cox <rsc@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
2020-12-11doc: make clear that Go 1.4 is not required for bootstrapRuss Cox
Go 1.4 does not work on some systems, including the most recent versions of macOS. Make it clearer that that's not the only way to bootstrap Go. Change-Id: I7c03d6808e43bf26283a53eab2bb0b2dc4af73af Reviewed-on: https://go-review.googlesource.com/c/go/+/277216 Trust: Russ Cox <rsc@golang.org> Run-TryBot: Russ Cox <rsc@golang.org> TryBot-Result: Go Bot <gobot@golang.org> Reviewed-by: Ian Lance Taylor <iant@golang.org>
2020-10-09doc: update install docs for 387->softfloat transitionKeith Randall
Fixes #41861 Change-Id: I7aa9370c7762986ee07ba6ff7f6ebda067559f06 Reviewed-on: https://go-review.googlesource.com/c/go/+/260757 Trust: Keith Randall <khr@golang.org> Reviewed-by: Ian Lance Taylor <iant@golang.org>
2020-09-23all: add GOOS=iosCherry Zhang
Introduce GOOS=ios for iOS systems. GOOS=ios matches "darwin" build tag, like GOOS=android matches "linux" and GOOS=illumos matches "solaris". Only ios/arm64 is supported (ios/amd64 is not). GOOS=ios and GOOS=darwin remain essentially the same at this point. They will diverge at later time, to differentiate macOS and iOS. Uses of GOOS=="darwin" are changed to (GOOS=="darwin" || GOOS=="ios"), except if it clearly means macOS (e.g. GOOS=="darwin" && GOARCH=="amd64"), it remains GOOS=="darwin". Updates #38485. Change-Id: I4faacdc1008f42434599efb3c3ad90763a83b67c Reviewed-on: https://go-review.googlesource.com/c/go/+/254740 Trust: Cherry Zhang <cherryyz@google.com> Run-TryBot: Cherry Zhang <cherryyz@google.com> TryBot-Result: Go Bot <gobot@golang.org> Reviewed-by: Austin Clements <austin@google.com>
2020-08-28doc: add linux/riscv64 valid combinationSantiago De la Cruz
Mention valid combination GOOS=linux and GOARCH=riscv64 in the "Installing Go from source" document. Updates #27532 Change-Id: I8c1406087132f5c82a2eee5dbcda95d53c64d263 GitHub-Last-Rev: ee74ff9517bd428b75400956d5b7f774ff800ae5 GitHub-Pull-Request: golang/go#41063 Reviewed-on: https://go-review.googlesource.com/c/go/+/250997 Reviewed-by: Tobias Klauser <tobias.klauser@gmail.com>
2020-07-01doc: add riscv64 to ports listTobias Klauser
Mention support for the 64-bit RISC-V instruction set (GOARCH=riscv64) in the "Installing Go from source" document. Also sort the list of supported instruction sets alphabetically. Updates #27532 Change-Id: I07a443044a41a803853978dd7f7446de89ecceb5 Reviewed-on: https://go-review.googlesource.com/c/go/+/240377 Reviewed-by: Alberto Donizetti <alb.donizetti@gmail.com>
2020-05-19doc: require macOS 10.12 or laterIan Lance Taylor
For #23011 Change-Id: I3137820af975301e251b0a23a9349c544b42c70b Reviewed-on: https://go-review.googlesource.com/c/go/+/234521 Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
2020-04-08doc: remove darwin/386, darwin/arm from ports listAustin Clements
Updates #37611. Change-Id: I7ae5a61d2e2189fd48ac3548e370e0de1dd79832 Reviewed-on: https://go-review.googlesource.com/c/go/+/227343 Run-TryBot: Austin Clements <austin@google.com> TryBot-Result: Gobot Gobot <gobot@golang.org> Reviewed-by: Cherry Zhang <cherryyz@google.com>
2020-03-28doc: decrease prominence of GOROOT_BOOTSTRAPGiovanni Bajo
Go build scripts on UNIX (make.bash, all.bash) have not required GOROOT_BOOTSTRAP since August 2017 (CL 57753). Windows build scripts have followed suit since CL 96455. Most people building Go will have a Go toolchain in their PATH and will not need to specify a different toolchain. This CL removes the GOROOT_BOOTSTRAP mention from the contribution guide (it was there for Windows only, but it's not required anymore). The guide is meant to be light and clear for beginners and is not supposed to be a reference, so there's not need to keep mentioning GOROOT_BOOTSTRAP. Also update install-source.html to reflect the current status quo, where using the PATH is probably the first and most used default, and GOROOT_BOOTSTRAP is just an option. Change-Id: Iab453e61b0c749c256aaaf81ea9b2ae58822cb89 Reviewed-on: https://go-review.googlesource.com/c/go/+/224717 Run-TryBot: Giovanni Bajo <rasky@develer.com> TryBot-Result: Gobot Gobot <gobot@golang.org> Reviewed-by: Rob Pike <r@golang.org>
2019-12-07doc: add missing p in install from source pageAlberto Donizetti
The last paragraph in golang.org/doc/install/source#fetch is missing a p tag, so it doesn't get formatted with the 'max-width: 50rem' like all the other text in the page. Add it. Change-Id: I1a981dd2afde561b4ab21bd90ad99b3a146111f6 Reviewed-on: https://go-review.googlesource.com/c/go/+/210122 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
2019-11-02doc: update ports list description to reflect current statusAlberto Donizetti
This change updates the GOARCH/GOOS discussion at the top of the "Installing Go from source" document to better reflect the current status. In particular: - The GOARCH list now focuses on simply listing the supported architectures, with no notes about their supposed "maturity", since the same GOARCH can be mature on a GOOS and not so mature on another. - Outdated notes about some archs being new and "not well-exercised" have been removed in favour of a following list of which ports are first class. - The list of supported OS has been updated (added: AIX, Illumos), and sorted in alphabetical order. - A note about the runtime support being the same for all ARCHS, "including garbage collection and efficient array slicing and" etc etc has been removed, since it doesn't seem particularly relevant in a "install from source" instruction page, and it's likely a leftover from the time this doc page was the landing place for new people and it felt the need to "sell" Go. Updates #27689 Fixes #35009 Change-Id: Ic4eca91dca3135adc7bed4fe00b4f157768f0e81 Reviewed-on: https://go-review.googlesource.com/c/go/+/202197 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
2019-08-09doc/install-source: create distinction between steps that involve "git clone"K. "pestophagous" Heller
Prior doc implied that "git clone" was one way to obtain a go1.4 bootstrap toochain, but it did not state this outright. Further, the doc did not make it explicit in the "Fetch the repository" section that one must necessarily "git clone" a second time in the (presumed-to-be-uncommon) case where "git clone" had already been perfomed in the "compiler binaries" section. Updates #33402 Change-Id: Id70a6587b6ee09aca13559d63868b75cb07dff1e Reviewed-on: https://go-review.googlesource.com/c/go/+/188900 Reviewed-by: Ian Lance Taylor <iant@golang.org>
2019-08-09doc/install-source.html: add new GOOS and GOARCHesAgniva De Sarker
And also insert new paragraphs between GOOS and GOARCH listings for better readability. Fixes #28142 Fixes #26513 Change-Id: Ie92e98dbfd924e80032a12afbfa02f30e3a6f916 Reviewed-on: https://go-review.googlesource.com/c/go/+/189578 Reviewed-by: Andrew Bonventre <andybons@golang.org>
2019-06-17cmd/go: document GOBIN and 'go install' locationsJay Conrod
* In doc/install-source.html, clarify the meaning of $GOBIN and describe where executables from the Go distribution are installed. Also describe $GOPATH, since it provides a default value for $GOBIN and may conflict with $GOROOT. * Add more detail to 'go help install' as well. Fixes #31576 Change-Id: Ib8a8c21677c3aa0ebef97a3b587b6f8fe338b80e Reviewed-on: https://go-review.googlesource.com/c/go/+/182341 Run-TryBot: Jay Conrod <jayconrod@google.com> TryBot-Result: Gobot Gobot <gobot@golang.org> Reviewed-by: Bryan C. Mills <bcmills@google.com>
2019-04-04cmd/compile: add saturating conversions on wasmRichard Musiol
This change adds the GOWASM option "satconv" to enable the generation of experimental saturating (non-trapping) float-to-int conversions. It improves the performance of the conversion by 42%. Previously the conversions had already been augmented with helper functions to have saturating behavior. Now Wasm.rules is always using the new operation names and wasm/ssa.go is falling back to the helpers if the feature is not enabled. The feature is in phase 4 of the WebAssembly proposal process: https://github.com/WebAssembly/meetings/blob/master/process/phases.md More information on the feature can be found at: https://github.com/WebAssembly/nontrapping-float-to-int-conversions/blob/master/proposals/nontrapping-float-to-int-conversion/Overview.md Change-Id: Ic6c3688017054ede804b02b6b0ffd4a02ef33ad7 Reviewed-on: https://go-review.googlesource.com/c/go/+/170119 Reviewed-by: Cherry Zhang <cherryyz@google.com> Run-TryBot: Cherry Zhang <cherryyz@google.com> TryBot-Result: Gobot Gobot <gobot@golang.org>
2019-03-28cmd/compile: add sign-extension operators on wasmRichard Musiol
This change adds the GOWASM option "signext" to enable the generation of experimental sign-extension operators. The feature is in phase 4 of the WebAssembly proposal process: https://github.com/WebAssembly/meetings/blob/master/process/phases.md More information on the feature can be found at: https://github.com/WebAssembly/sign-extension-ops/blob/master/proposals/sign-extension-ops/Overview.md Change-Id: I6b30069390a8699fbecd9fb4d1d61e13c59b0333 Reviewed-on: https://go-review.googlesource.com/c/go/+/168882 Reviewed-by: Cherry Zhang <cherryyz@google.com> Reviewed-by: Ian Lance Taylor <iant@golang.org> Run-TryBot: Cherry Zhang <cherryyz@google.com> TryBot-Result: Gobot Gobot <gobot@golang.org>
2019-03-23cmd/go: add GOWASM environment variableRichard Musiol
This change adds the environment variable GOWASM, which is a comma separated list of experimental WebAssembly features that the compiled WebAssembly binary is allowed to use. The default is to use no experimental features. Initially there are no features avaiable. More information about feature proposals can be found at https://github.com/WebAssembly/proposals Change-Id: I4c8dc534c99ecff8bb075dded0186ca8f8decaef Reviewed-on: https://go-review.googlesource.com/c/go/+/168881 Run-TryBot: Richard Musiol <neelance@gmail.com> TryBot-Result: Gobot Gobot <gobot@golang.org> Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
2019-03-13cmd/compile: add processor level selection support to ppc64{,le}Carlos Eduardo Seo
ppc64{,le} processor level selection allows the compiler to generate instructions targeting newer processors and processor-specific optimizations without breaking compatibility with our current baseline. This feature introduces a new environment variable, GOPPC64. GOPPC64 is a GOARCH=ppc64{,le} specific option, for a choice between different processor levels (i.e. Instruction Set Architecture versions) for which the compiler will target. The default is 'power8'. Change-Id: Ic152e283ae1c47084ece4346fa002a3eabb3bb9e Reviewed-on: https://go-review.googlesource.com/c/go/+/163758 Run-TryBot: Carlos Eduardo Seo <cseo@linux.vnet.ibm.com> TryBot-Result: Gobot Gobot <gobot@golang.org> Reviewed-by: David Chase <drchase@google.com>
2019-02-13doc: don't use "go tool vet" as an exampleIan Lance Taylor
Fixes #30199 Change-Id: Ib4586e3facb8c0985c8882482d94843b648b9d2f Reviewed-on: https://go-review.googlesource.com/c/162257 Run-TryBot: Ian Lance Taylor <iant@golang.org> TryBot-Result: Gobot Gobot <gobot@golang.org> Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
2019-02-10doc: remove last pieces of advice to set GOROOTDaniel Martí
install.html still insisted that GOROOT must be set if a binary install of Go is set up in a custom directory. However, since 1.10, this has been unnecessary as the GOROOT will be found based on the location of the 'go' binary being run. Likewise, install-source.html includes an 'export GOROOT' line in a section that only talks about explicitly setting GOARCH and GOOS, which is optional. We don't want to have users think it is recommended to set GOROOT here either, so remove the unnecessary line. Change-Id: I7dfef09f9a1d003e0253b793d63ea40d5cf1837f Reviewed-on: https://go-review.googlesource.com/c/161758 Reviewed-by: Andrew Bonventre <andybons@golang.org> Reviewed-by: Ian Lance Taylor <iant@golang.org> Run-TryBot: Daniel Martí <mvdan@mvdan.cc> TryBot-Result: Gobot Gobot <gobot@golang.org>
2018-09-05doc: add GOMIPS64 to source installation docsMilan Knezevic
Fixes #27258 Change-Id: I1ac75087e2b811e6479990e12d71f2c1f4f47b64 Reviewed-on: https://go-review.googlesource.com/132015 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
2018-06-19doc: update "Mac OS X", "OS X" to macOS; bump up to 10.10Dmitri Shuralyov
The name was "Mac OS X" during versions 10.0 to 10.7. It was renamed to "OS X" starting from 10.8 until 10.11. The current name is "macOS" starting with 10.12. [1] Previous changes (e.g., CL 47252) updated "Mac OS X" to macOS in some places, but not everywhere. This CL updates remaining instances for consistency. Only the pages that display current information were updated; historical pages such as release notes for older Go releases, past articles, blog posts, etc., were left in original form. Rename the "#osx" anchor to "#macos" on /doc/install page, along with the single reference to it on the same page. Add an empty div with id="osx" to not break old links. Update minimum macOS version from 10.8 to 10.10 per #23122. [1]: https://en.wikipedia.org/wiki/macOS#History Updates #23122. Change-Id: I69fe4b85e83265b9d99f447e3cc5230dde094869 Reviewed-on: https://go-review.googlesource.com/119855 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
2018-06-13doc: use HTTPS for linksSuriyaa Sundararuban
Change-Id: I9d2d25df067ca573589db5ff18296a5ec33866be Reviewed-on: https://go-review.googlesource.com/118595 Reviewed-by: Ian Lance Taylor <iant@golang.org>
2018-04-11doc: switch from spaces to tabs for indentation in example codeJeremy Schlatter
This is the standard that gofmt uses. Change-Id: I30e70611ccd0d3bbaa500fa84e9d1ba75970f0bc GitHub-Last-Rev: b2b7af0df9759ad447b6fd3551ea356804d136b2 GitHub-Pull-Request: golang/go#24802 Reviewed-on: https://go-review.googlesource.com/106123 Reviewed-by: Ian Lance Taylor <iant@golang.org>
2018-01-30doc: add GOMIPS to source installation docsBrad Fitzpatrick
Also close </li> tags. Fixes #23614 Change-Id: Icabcd577ef7df43e54d2b0068ee54614ba65bea1 Reviewed-on: https://go-review.googlesource.com/90815 Reviewed-by: Cherry Zhang <cherryyz@google.com>
2018-01-09doc: s/tool chain/toolchain/Russ Cox
We were not being consistent. Standardize on toolchain. Change-Id: Id0e756b5214ce4a1341f733634ed95263f03a61c Reviewed-on: https://go-review.googlesource.com/87017 Run-TryBot: Russ Cox <rsc@golang.org> Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org> Reviewed-by: Ian Lance Taylor <iant@golang.org>
2017-11-27doc: update URL of the go1.4 source snapshot to use dl.google.comAndrew Bonventre
Updates golang/go#20672 Change-Id: I88a1d8693ef9d1e4758719603ce1f3c3f6b920bc Reviewed-on: https://go-review.googlesource.com/79936 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
2017-11-22doc: update the URL of the latest go1.4 source snapshotBrad Fitzpatrick
Updates golang/go#20672 Change-Id: I3c62b1606aec93e188255f1701c0af569d540016 Reviewed-on: https://go-review.googlesource.com/79276 Reviewed-by: Ian Lance Taylor <iant@golang.org>
2017-10-12doc: recommend building Go 1.4 with CGO_ENABLED=0Ian Lance Taylor
Fixes #21054 Change-Id: I016486dc62c04a80727f8da7d1dcec52f2c7f344 Reviewed-on: https://go-review.googlesource.com/62291 Reviewed-by: Giovanni Bajo <rasky@develer.com> Reviewed-by: Chris Broadfoot <cbro@golang.org>
2017-09-13doc: mention s390x in environment section of install-source.htmlMichael Munday
Change-Id: I521ba94356165efc3252ca4b3d364a2bbabd4aab Reviewed-on: https://go-review.googlesource.com/58010 Run-TryBot: Michael Munday <mike.munday@ibm.com> TryBot-Result: Gobot Gobot <gobot@golang.org> Reviewed-by: Ian Lance Taylor <iant@golang.org>
2017-08-24doc: document go1.9Chris Broadfoot
Change-Id: I97075f24319a4b96cbeb9e3ff2e7b2056ff59e32 Reviewed-on: https://go-review.googlesource.com/58651 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
2017-05-31doc: update bootstrap archive URLChris Broadfoot
This includes the patch for systems that build PIE executables by defaul Updates #20276. Change-Id: Iecf8dfcf11bc18d397b8075559c37e3610f825cb Reviewed-on: https://go-review.googlesource.com/44470 Reviewed-by: Ian Lance Taylor <iant@golang.org>
2017-04-07doc: document go1.8.1Chris Broadfoot
Change-Id: I9282c1907204ec5c6363de84faec222a38300c9f Reviewed-on: https://go-review.googlesource.com/39919 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
2017-02-16doc: document go1.8Chris Broadfoot
Change-Id: Ie2144d001c6b4b2293d07b2acf62d7e3cd0b46a7 Reviewed-on: https://go-review.googlesource.com/37130 Reviewed-by: Russ Cox <rsc@golang.org>
2017-01-24doc: clarify what to do with Go 1.4 when installing from sourceIan Lance Taylor
You have to actually run make.bash (or make.bat). Update #18771. Change-Id: Ie6672a4e4abde0150c1ae57cabb1222de2c78716 Reviewed-on: https://go-review.googlesource.com/35632 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
2016-12-06doc: document the mips port in install-source.htmlShenghou Ma
While we're at it, also mention OpenBSD/ARM support. Change-Id: I4df4a158b67d11720146d05a235099d452295170 Reviewed-on: https://go-review.googlesource.com/33854 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
2016-12-02doc: update suggested Go installation versionKevin Burke
Previously the docs suggested downloading 1.7.2 (no good) or 1.7.3 (has security flaw). Change-Id: Ifabe85908df8d6591c0957ef4bb1b800fc145793 Reviewed-on: https://go-review.googlesource.com/33808 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
2016-11-30doc, cmd/go: adjust documentation for default GOPATHRuss Cox
Replaces CL 33356. Fixes #17262. Change-Id: Idfb2343e90771775e51a66c63760f458737a288c Reviewed-on: https://go-review.googlesource.com/33730 Run-TryBot: Russ Cox <rsc@golang.org> Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
2016-11-08doc: reference go1.4-bootstrap-20161024.tar.gzBrad Fitzpatrick
Updates #16352 Change-Id: I214c87579ef21ced8d0ba94aa170dd7780afec4b Reviewed-on: https://go-review.googlesource.com/32312 Reviewed-by: Ian Lance Taylor <iant@golang.org>
2016-10-19doc: update install-source.html for SSA in Go 1.8Quentin Smith
Fixes #17491 Change-Id: Ic070cbed60fa893fed568e8fac448b86cd3e0cbc Reviewed-on: https://go-review.googlesource.com/31411 Reviewed-by: Ian Lance Taylor <iant@golang.org> Reviewed-by: Russ Cox <rsc@golang.org>
2016-10-17doc: document go1.7.2Chris Broadfoot
Change-Id: I34b3650ee9512879ff7528336813a7850c46ea90 Reviewed-on: https://go-review.googlesource.com/31311 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
2016-09-12doc: document minimum OS X version as 10.8Brad Fitzpatrick
The download page says "OS X 10.8 or later", but other pages said 10.7. Say 10.8 everywhere. Turns out Go doesn't even compile on OS X 10.7 (details in bug) and we only run builders for OS X 10.8+, which is likely why 10.7 regressed. Until recently we only had OS X 10.10 builders, even. We could run 10.7 builders, but there's basically no reason to do so, especially with 10.12 coming out imminently. Fixes #16625 Change-Id: Ida6e20fb6c54aea0a3757235b708ac1c053b8c04 Reviewed-on: https://go-review.googlesource.com/28870 Reviewed-by: Chris Broadfoot <cbro@golang.org>
2016-09-07doc: document go1.7.1Chris Broadfoot
Change-Id: I4dc1ff7bfc67351a046f199dee8b7a9eadb1e524 Reviewed-on: https://go-review.googlesource.com/28693 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
2016-08-15doc: update version tag in source install instructionsChris Broadfoot
Change-Id: Id83e0371b7232b01be83640ef1e47f9026cf2a23 Reviewed-on: https://go-review.googlesource.com/27055 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
2016-06-20doc: update architectures on source install instructionsAndrew Gerrand
Fixes #16099 Change-Id: I334c1f04dfc98c4a07e33745819d890b5fcb1673 Reviewed-on: https://go-review.googlesource.com/24243 Reviewed-by: Josh Bleecher Snyder <josharian@gmail.com>
2016-05-24all: fixed a handful of typosRobert Griesemer
Change-Id: Ib0683f27b44e2f107cca7a8dcc01d230cbcd5700 Reviewed-on: https://go-review.googlesource.com/23404 Reviewed-by: Alan Donovan <adonovan@google.com>
2016-05-09doc: update number of supported instruction setsMikhail Gusarov
Current number was out-of-date since adding MIPS. Change-Id: I565342a92de3893b75cdfb76fa39f7fdf15672da Reviewed-on: https://go-review.googlesource.com/22952 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
2016-04-14doc: add classes to version tags in source install instructionsAndrew Gerrand
This will allow us to mechanically substitute these strings using javascript (in a forthcoming change to x/tools/godoc). Updates #14371 Change-Id: I96e876283060ffbc9f3eabaf55d6b880685453e1 Reviewed-on: https://go-review.googlesource.com/22055 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
2016-03-01doc: update release tag in source directions to go1.6nwidger
Fixes #14371 Change-Id: I8e9e4b2b89083f5a947e791c011912fdf365a11e Reviewed-on: https://go-review.googlesource.com/19996 Reviewed-by: Andrew Gerrand <adg@golang.org>
2016-02-25doc: add android/arm as a valid GOOS/GOARCH combinationBurcu Dogan
Fixes #14497. Change-Id: Ibdd55acf9e416873c64f8751c2f65f7ccdb1d500 Reviewed-on: https://go-review.googlesource.com/19914 Reviewed-by: David Crawshaw <crawshaw@golang.org>
generated by cgit v1.3 (git 2.53.0) at 2026-04-15 19:52:23 +0000