aboutsummaryrefslogtreecommitdiff
path: root/doc
AgeCommit message (Collapse)Author
2020-12-16[release-branch.go1.15] doc/go1.15: mention 1.15.3 cgo restriction on empty ↵Ian Lance Taylor
structs For #40954 Change-Id: I6a30aed31a16e820817f4ca5c7f591222e922946 Reviewed-on: https://go-review.googlesource.com/c/go/+/277432 Trust: Ian Lance Taylor <iant@golang.org> Reviewed-by: Keith Randall <khr@golang.org> (cherry picked from commit 129bb1917b4914f0743ec9b4ef0dfb74df39c07d) Reviewed-on: https://go-review.googlesource.com/c/go/+/278573 Run-TryBot: Ian Lance Taylor <iant@golang.org> TryBot-Result: Go Bot <gobot@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
2020-09-02[release-branch.go1.15] doc/go1.14: document json.Umarshal map key support ↵ShihCheng Tu
of TextUnmarshaler Document that json.Unmarshal supports map keys whose underlying types implement encoding.TextUnmarshaler. Updates #38801. Fixes #41178. Change-Id: Icb9414e9067517531ba0da910bd4a2bb3daace65 Reviewed-on: https://go-review.googlesource.com/c/go/+/237857 Reviewed-by: Daniel Martí <mvdan@mvdan.cc> Run-TryBot: Daniel Martí <mvdan@mvdan.cc> TryBot-Result: Gobot Gobot <gobot@golang.org> (cherry picked from commit 47b450997778163dfed6f58cae379d928fc37687) Reviewed-on: https://go-review.googlesource.com/c/go/+/252618 Run-TryBot: Dmitri Shuralyov <dmitshur@golang.org> Reviewed-by: Carlos Amedee <carlos@golang.org>
2020-08-13[release-branch.go1.15] doc/go1.15: clarify external linking can still be ↵Cherry Zhang
used for building PIE In Go 1.15 we switched the default linking mode for PIE on Linux/AMD64 and Linux/ARM64 to internal linking. Clarify that the previous behavior (external linking) can still be used with a flag. Updates #40719. Change-Id: Ib7042622bc91e1b1aa31f520990d03b5eb6c56bb Reviewed-on: https://go-review.googlesource.com/c/go/+/248199 Reviewed-by: Ian Lance Taylor <iant@golang.org> (cherry picked from commit 50f63a7ae4b7f951fa894b96633b1716adca55fa) Reviewed-on: https://go-review.googlesource.com/c/go/+/248330
2020-08-13[release-branch.go1.15] doc/go1.15: include behavior updates to the context ↵Andrew
package Fixes #40737 Change-Id: I8e2c1e1653d427af1ded6d61df1aa450e3c4d35c Reviewed-on: https://go-review.googlesource.com/c/go/+/248329 Run-TryBot: Andrew Bonventre <andybons@golang.org> TryBot-Result: Gobot Gobot <gobot@golang.org> Reviewed-by: Ian Lance Taylor <iant@golang.org> (cherry picked from commit b2353174db1349f15113416b4df2a833db6058a6) Reviewed-on: https://go-review.googlesource.com/c/go/+/248331 Reviewed-by: Andrew Gerrand <adg@golang.org>
2020-08-11[release-branch.go1.15] all: merge master into release-branch.go1.15Andrew
5c7748dc9d doc/go1.15: encoding/json's CL 191783 was reverted 5ff5b3c557 doc/go1.15: remove draft notice 5ae1d62ee3 CONTRIBUTORS: update for the Go 1.15 release 7ad776dda5 doc/go1.15: document crypto/tls permanent error a93a4c1780 runtime: make nanotime1 reentrant Updates #40697 Change-Id: Ie39896ee6304544cc9e9c1938bdf176f1dcf8766 Reviewed-on: https://go-review.googlesource.com/c/go/+/247900 Run-TryBot: Andrew Bonventre <andybons@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org> Reviewed-by: Carlos Amedee <carlos@golang.org> TryBot-Result: Gobot Gobot <gobot@golang.org>
2020-08-01doc/go1.15: fix a few trivial inconsistenciesToshihiro Shiino
For #37419 Change-Id: I8ede539df5d5344aeb44ba1a7e2383363d92157f Reviewed-on: https://go-review.googlesource.com/c/go/+/245977 Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org> Run-TryBot: Dmitri Shuralyov <dmitshur@golang.org> TryBot-Result: Gobot Gobot <gobot@golang.org>
2020-07-24doc/go1.15: surface the crypto/x509 CommonName deprecation noteFilippo Valsorda
Updates #39568 Updates #37419 Updates #24151 Change-Id: I44c940e09e26a039076396bbfecb2b1574197cf7 Reviewed-on: https://go-review.googlesource.com/c/go/+/243221 Reviewed-by: Kevin Burke <kev@inburke.com>
2020-07-23doc/go1.15: announce GO386=387 deprecationAustin Clements
For #40255. Updates #37419. Change-Id: If9210c855cc2eea079e7e469463d4203888748f7 Reviewed-on: https://go-review.googlesource.com/c/go/+/243137 Reviewed-by: Andrew Bonventre <andybons@golang.org>
2020-07-17doc/go1.15: add release notes for math/cmplxBrian Kessler
Updates #37419 Change-Id: Id7c9aba518c826c1a6fccbbf82210072bd3346f3 Reviewed-on: https://go-review.googlesource.com/c/go/+/242903 Reviewed-by: Emmanuel Odeke <emm.odeke@gmail.com> Reviewed-by: Robert Griesemer <gri@golang.org>
2020-07-17go/printer: remove exported StdFormat flagDmitri Shuralyov
The StdFormat flag was added as part of CL 231461, where the primary aim was to fix the bug #37476. It's expected that the existing printer modes only adjust spacing but do not change any of the code text itself. A new printing flag served as a way for cmd/gofmt and go/format to delegate a part of formatting work to the printer—where it's more more convenient and efficient to perform—while maintaining current low-level printing behavior of go/printer unmodified. We already have cmd/gofmt and the go/format API that implement standard formatting of Go source code, so there isn't a need to expose StdFormat flag to the world, as it can only cause confusion. Consider that to format source in canonical gofmt style completely it may require tasks A, B, C to be done. In one version of Go, the printer may do both A and B, while cmd/gofmt and go/format will do the remaining task C. In another version, the printer may take on doing just A, while cmd/gofmt and go/format will perform B and C. This makes it hard to add a gofmt-like mode to the printer without compromising on above fluidity. This change prefers to shift back some complexity to the implementation of the standard library, allowing us to avoid creating the new exported printing flag just for the internal needs of gofmt and go/format today. We may still want to re-think the API and consider if something better should be added, but unfortunately there isn't time for Go 1.15. We are not adding new APIs now, so we can defer this decision until Go 1.16 or later, when there is more time. For #37476. For #37453. For #39489. For #37419. Change-Id: I0bb07156dca852b043487099dcf05c5350b29e20 Reviewed-on: https://go-review.googlesource.com/c/go/+/240683 Reviewed-by: Robert Griesemer <gri@golang.org> Reviewed-by: Russ Cox <rsc@golang.org>
2020-07-09doc/go1.15: fix TODO about -buildmode=pieAustin Clements
Updates #37419. Change-Id: If77067eb348de47a4b101325de8a43502383b6d3 Reviewed-on: https://go-review.googlesource.com/c/go/+/241740 Reviewed-by: Cherry Zhang <cherryyz@google.com>
2020-07-09doc/go1.15: add line for testing streaming changeJean de Klerk
Updates #37419. Updates #38458. Updates #24929. Change-Id: I793bb20fa9db4432fc3a5b69956b7108e4695081 Reviewed-on: https://go-review.googlesource.com/c/go/+/241660 Run-TryBot: Jean de Klerk <deklerk@google.com> TryBot-Result: Gobot Gobot <gobot@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
2020-07-08doc/editors.html: update VS Code Go extension urlHana (Hyang-Ah) Kim
Change-Id: I7aa73861de053db6b424f113733de9caba19145b Reviewed-on: https://go-review.googlesource.com/c/go/+/241086 Reviewed-by: Andrew Bonventre <andybons@golang.org>
2020-07-07crypto/x509/pkix: print non-standard parsed Names at the endFilippo Valsorda
This doesn't change how ExtraNames are printed, so as not to cause unnecessary churn of current outputs. Switched the ExtraNames check to a nil check as we are checking for just-parsed values. Fixes #39924 Fixes #39873 Change-Id: Ifa07cfc1a057d73643710a774ef8a154222db187 Reviewed-on: https://go-review.googlesource.com/c/go/+/240543 Run-TryBot: Filippo Valsorda <filippo@golang.org> Reviewed-by: Katie Hockman <katie@golang.org> TryBot-Result: Gobot Gobot <gobot@golang.org>
2020-07-07doc/go1.15: add html/template and text/template docsFilippo Valsorda
Updates #37419 Change-Id: I23abfeabc6be704aad9da2649bbbe7c8e237dfab Reviewed-on: https://go-review.googlesource.com/c/go/+/240546 Reviewed-by: Carlos Amedee <carlos@golang.org>
2020-07-07doc/go1.15: update Go 1.15 release notes using relnoteCarlos Amedee
The additions were generated using golang.org/x/build/cmd/relnote. Updates #37419 Change-Id: I99e934377e4bb511c44908039ad6d3bfd3ee35ce Reviewed-on: https://go-review.googlesource.com/c/go/+/241065 Run-TryBot: Carlos Amedee <carlos@golang.org> Reviewed-by: Alexander Rakoczy <alex@golang.org> Reviewed-by: Andrew Bonventre <andybons@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org> TryBot-Result: Gobot Gobot <gobot@golang.org>
2020-07-05doc/go1.15: fix wording in a few placesAlberto Donizetti
Change-Id: I1dc6871bdab7f3048eacd6738fdcfa64b8700c8a Reviewed-on: https://go-review.googlesource.com/c/go/+/240998 Reviewed-by: Ian Lance Taylor <iant@golang.org>
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-06-30doc/go1.15: add encoding/asn1 note about minimal encodingRoland Shoemaker
Also fix missing <code> tags in the other encoding/asn1 note. Updates #37419 Change-Id: Ic0e9131016b44ed864629aa8d0a7fddb57146d21 Reviewed-on: https://go-review.googlesource.com/c/go/+/240518 Reviewed-by: Filippo Valsorda <filippo@golang.org>
2020-06-30doc: add note about missing lock in sample codeFerenc Szabo
The sample code in 'Interfaces and methods' section contains a data race. Handlers are served concurrently. The handler does write and read operations; `go test -race` would fail (with concurrent requests). Since the doc is frozen and the code remains less cluttered without locks/atomic, don't change the sample code. Change-Id: I654b324d2f0b7f48497822751907c7d39e2f0e3d Reviewed-on: https://go-review.googlesource.com/c/go/+/239877 Reviewed-by: Rob Pike <r@golang.org>
2020-06-29doc/go1.15: remove encoding/xml docIan Lance Taylor
The change is rolled back in CL 240179. For #35151 For #39876 Change-Id: Id26ccbdb482772ac31c642156a9900102397b043 Reviewed-on: https://go-review.googlesource.com/c/go/+/240012 Reviewed-by: Alberto Donizetti <alb.donizetti@gmail.com> Reviewed-by: Emmanuel Odeke <emm.odeke@gmail.com>
2020-06-29doc: add alt attribute to gopher image in help.htmlAlexander Nohe
This adds an alt tag for accessibility. The alt text is a visual description of the text that is read out loud to users using a screen reader. The HTML specifications indicate that alt tags for decorative images should be left blank. Fixes #39861 Change-Id: I76c39a461ceabe685826aa46e4f26ad893d50634 Reviewed-on: https://go-review.googlesource.com/c/go/+/240258 Reviewed-by: Alexander Nohe <alex.nohe427@gmail.com> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
2020-06-29doc/go1.15: add release note for encoding/asn1Roland Shoemaker
Updates #37419 Change-Id: I05368efbedd8c7e0b50cd691559491699c3a0945 Reviewed-on: https://go-review.googlesource.com/c/go/+/240201 Reviewed-by: Filippo Valsorda <filippo@golang.org>
2020-06-28doc: fix typos and grammatical errors in contribute.htmlJie Ma
Fixed some typos and grammatical errors in contribute.html Change-Id: Ifb31f22d876b7bea84b5e130870c26813b2fa139 GitHub-Last-Rev: 43519198859ca8f5e1c870b8f3eeb1b465aa6bc5 GitHub-Pull-Request: golang/go#39892 Reviewed-on: https://go-review.googlesource.com/c/go/+/240277 Reviewed-by: Ian Lance Taylor <iant@golang.org>
2020-06-26doc/go1.15: fix typos and wording in a few placesAlberto Donizetti
Change-Id: Ib1fc7a8305f3bc698b9022e0a565ccbcf687e0d1 Reviewed-on: https://go-review.googlesource.com/c/go/+/240158 Reviewed-by: Ian Lance Taylor <iant@golang.org>
2020-06-26doc/go1.14: crypto/tls.Config.NameToCertificate is deprecatedIan Lance Taylor
Also crypto/tls.Config.BuildNameToCertificate. Note that this field and method were deprecated in the Go 1.14 release, so this change is to the 1.14 release notes. Fixes #37626 Change-Id: If8549bc746f42a93f1903439e1b464b3e81e2c19 Reviewed-on: https://go-review.googlesource.com/c/go/+/240005 Reviewed-by: Filippo Valsorda <filippo@golang.org>
2020-06-26doc/go1.15: fix bad link to crypto/tlsAlberto Donizetti
Change-Id: Ie81579cbb1873349a91280f5aebe59624fcb1ef8 Reviewed-on: https://go-review.googlesource.com/c/go/+/240157 Reviewed-by: Emmanuel Odeke <emm.odeke@gmail.com>
2020-06-25doc/go1.15: mention consequence of os.File.ReadFromIan Lance Taylor
Now that we've added a os.File.ReadFrom method, io.CopyBuffer to a os.File will no longer use the provided buffer. For #16474 For #36817 For #37419 Change-Id: I79a3bf778ff93eab88e88dd9ecbb8c7ea101e868 Reviewed-on: https://go-review.googlesource.com/c/go/+/238864 Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
2020-06-25doc/faq: fix a grammar mistakeKerollos Magdy
Change-Id: Ifa060f5f91d7b964eb180465245104411310d423 GitHub-Last-Rev: cd1862f2ca721a4f3d4ede7bcb3e7759ce96c6d5 GitHub-Pull-Request: golang/go#39780 Reviewed-on: https://go-review.googlesource.com/c/go/+/239388 Reviewed-by: Ian Lance Taylor <iant@golang.org>
2020-06-18doc/go1.15: document new bufio.ErrBadReadCountIan Lance Taylor
For #37419 For #38053 Change-Id: I206f360ff4957bc7edc3c35dfc814b7bd5ec440c Reviewed-on: https://go-review.googlesource.com/c/go/+/237739 Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
2020-06-17doc/go1.15: enumerate ELF-based OSesAustin Clements
Users don't necessarily know if their OS is ELF-based. For #37419. Change-Id: I4a4256c5f5eb34211729e1311582bb0e210f1f8d Reviewed-on: https://go-review.googlesource.com/c/go/+/238240 Reviewed-by: Than McIntosh <thanm@google.com>
2020-06-16doc/go1.15: fix two typosAinar Garipov
Updates #37419. Change-Id: I9ecc706d44950b7de3e8fe4dde8cfab1904eee58 Reviewed-on: https://go-review.googlesource.com/c/go/+/238139 Reviewed-by: Ian Lance Taylor <iant@golang.org>
2020-06-16doc/go1.15: add missing slashesToshihiro Shiino
This saves a redirect and makes the document more consistent. For #37419 Change-Id: Ic3bd62f8caacf67ffe43a359624e11bed8b8cfaf Reviewed-on: https://go-review.googlesource.com/c/go/+/237540 Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
2020-06-15doc/go1.15: document go/printer.StdFormatIan Lance Taylor
For #37419 For #37453 For #37476 Change-Id: Ia032ec844773af421bc4217d5dd6e60996d8e91f Reviewed-on: https://go-review.googlesource.com/c/go/+/237740 Reviewed-by: Robert Griesemer <gri@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
2020-06-15doc/gccgo: change gold build instructions to use Git repositoryTobias Klauser
Use the binutils Git repository instead of CVS. Change-Id: I10100ca44d64ab3621367d1d4ac9e9a50d212d0d Reviewed-on: https://go-review.googlesource.com/c/go/+/237839 Reviewed-by: Ian Lance Taylor <iant@golang.org>
2020-06-15doc/gccgo: update GCC repository after migration to GitTobias Klauser
The GCC code repository is now hosted on Git. Adjust the instructions in gccgo_install.html accordingly. Change-Id: I443a8b645b63e63785979bc0554521e3dc3b0bf7 Reviewed-on: https://go-review.googlesource.com/c/go/+/237798 Reviewed-by: Ian Lance Taylor <iant@golang.org>
2020-06-13doc/go1.15: add release notes for database/sql and database/sql/driverAinar Garipov
Updates #37419. Change-Id: Ifb6aa9a671f677e1a3e908f0b75bf0da17a57ad0 Reviewed-on: https://go-review.googlesource.com/c/go/+/237397 Reviewed-by: Daniel Theophanes <kardianos@gmail.com>
2020-06-12doc/go1.15: sort debug/pe entry alphabeticallyIan Lance Taylor
For #37419 Change-Id: If98ecffbfd976cb66a87b1cce4e82b3ddee1639e Reviewed-on: https://go-review.googlesource.com/c/go/+/237738 Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
2020-06-11doc/go1.15: add code tagsToshihiro Shiino
Other command line arguments are written in code tags, so add a code tag for consistency. For #37419 Change-Id: I1948536c3a1860d93726484be2dc7bcb03dfdc2f Reviewed-on: https://go-review.googlesource.com/c/go/+/237539 Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
2020-06-11doc/go1.15: replace tab indentation with spacesToshihiro Shiino
Replace tab indentation with spaces for consistency, as all other indentation is done with spaces. For #37419 Change-Id: I728a75ae0d00e637f57eb455b6039ffc1a5feed2 Reviewed-on: https://go-review.googlesource.com/c/go/+/237538 Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
2020-06-10doc: document encoding/xml change in CL 203417Russ Cox
Change-Id: Ibc0228f166f449ec28d813f33bdb550fe7ba2b3e Reviewed-on: https://go-review.googlesource.com/c/go/+/236739 Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
2020-06-09crypto/tls: restore OCSP and SCTs during session resumptionRoland Shoemaker
Restore previously sent SCTs and stapled OCSP response during session resumption for both TLS 1.2 and 1.3. This behavior is somewhat complicated for TLS 1.2 as SCTs are sent during the server hello, so they override what is saved in ClientSessionState. It is likely that if the server is sending a different set of SCTs there is probably a reason for doing so, such as a log being retired, or SCT validation requirements changing, so it makes sense to defer to the server in that case. Fixes #39075 Change-Id: I3c0fa2f69c6bf0247a447c48a1b4c733a882a233 Reviewed-on: https://go-review.googlesource.com/c/go/+/234237 Reviewed-by: Filippo Valsorda <filippo@golang.org>
2020-06-09doc/go1.15: add remaining release notes for net/http and net/http/httputilFilippo Valsorda
Updates #37419 Change-Id: I3e37b650475aad4430aacd4655c02e5081ca6f5e Reviewed-on: https://go-review.googlesource.com/c/go/+/237019 Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
2020-06-09doc/go1.15: remove TODO in minor library changes sectionDmitri Shuralyov
The minor changes to the library section has been populated with TODOs for individual packages using relnote in CL 235757, and they've been resolved in the following CLs. We will look things over as part of finishing touches on the release notes, but this TODO is resolved for beta 1. For #37419. Change-Id: I942f81a957fe8df8f630b4406ca29f73602d080a Reviewed-on: https://go-review.googlesource.com/c/go/+/237157 Reviewed-by: Alexander Rakoczy <alex@golang.org> Reviewed-by: Carlos Amedee <carlos@golang.org>
2020-06-08all: avoid awkward wording from CL 236857Russ Cox
CL 236857 removed all uses of whitelist/blacklist, which is great. But it substituted awkward phrasing using allowlist/blocklist, especially as verbs or participles. This CL uses more standard English, like "allow the function" or "blocked functions" instead of "allowlist the function" or "blocklisted functions". Change-Id: I9106a2fdbd62751c4cbda3a77181358a8a6d0f13 Reviewed-on: https://go-review.googlesource.com/c/go/+/236917 Run-TryBot: Russ Cox <rsc@golang.org> Reviewed-by: Ian Lance Taylor <iant@golang.org>
2020-06-08doc/go1.15: add more release notes for crypto/tlsFilippo Valsorda
Updates #37419 Change-Id: I5e03adbf6d215d65aedbdeb7bdfe1ead8a838877 Reviewed-on: https://go-review.googlesource.com/c/go/+/236921 Reviewed-by: Katie Hockman <katie@golang.org>
2020-06-08doc/go1.15: add release notes for crypto and math/bigFilippo Valsorda
Updates #37419 Change-Id: I12f073697dc319e439f4ffe4e0aac7f6afb19a74 Reviewed-on: https://go-review.googlesource.com/c/go/+/236918 Reviewed-by: Katie Hockman <katie@golang.org>
2020-06-08doc/go1.15: add release notes for crypto/x509Filippo Valsorda
Updates #37419 Change-Id: Iedfd4b238980675be115c7e6e0a327d7745b5bed Reviewed-on: https://go-review.googlesource.com/c/go/+/236737 Reviewed-by: Katie Hockman <katie@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
2020-06-08doc/go1.15: add release notes for crypto/tlsKatie Hockman
Updates #37419 Change-Id: Ie81c0b03716799c132e90dc231ab816e6ae43469 Reviewed-on: https://go-review.googlesource.com/c/go/+/236166 Reviewed-by: Filippo Valsorda <filippo@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
2020-06-08doc/go1.15: document two noteworthy json changesDaniel Martí
I had a look at the changes between 1.14 and master, and these are the only two that seem relevant enough for the changelog. There was also CL 179337 to reuse values when decoding map elements, but it got reverted in CL 234559 and is not being included in 1.15. Updates #37419. Change-Id: Ib125415a953471ce29553a413d85aaf4b18a7a12 Reviewed-on: https://go-review.googlesource.com/c/go/+/236523 Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
7apu2bq3rhoylwmucxizk54afw5jyda7pho4j5zdcqpwkufke7zdzwad.onion