summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAgeFilesLines
* doc/go1.21: document that -pgo=auto enabled by defaultCherry Mui2023-05-171-2/+7
| | | | | | | | | | Updates #58099. Change-Id: I95c0397add696f677c86ab7618482e07eb4e9fda Reviewed-on: https://go-review.googlesource.com/c/go/+/495477 Run-TryBot: Cherry Mui <cherryyz@google.com> Reviewed-by: Austin Clements <austin@google.com> TryBot-Result: Gopher Robot <gobot@golang.org>
* doc/go1.21: document wasip1 portCherry Mui2023-05-171-1/+14
| | | | | | | | | | | Updates #58141. Change-Id: Iad11e7880efb37e9a1e17daf48d36b886725f75d Reviewed-on: https://go-review.googlesource.com/c/go/+/495476 Run-TryBot: Cherry Mui <cherryyz@google.com> Reviewed-by: Eli Bendersky <eliben@google.com> TryBot-Result: Gopher Robot <gobot@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
* doc/go1.21: document reflect.Value escape improvementsCherry Mui2023-05-161-0/+12
| | | | | | | | | | | | | With CL 408826, CL 413474, etc. reflect.ValueOf no longer unconditionally escapes its argument, allowing a Value's content to be allocated on the stack. Change-Id: I3a0af85c11e2fd0df42b056095565f0ce5548886 Reviewed-on: https://go-review.googlesource.com/c/go/+/494657 TryBot-Result: Gopher Robot <gobot@golang.org> Reviewed-by: David Chase <drchase@google.com> Run-TryBot: Cherry Mui <cherryyz@google.com> Reviewed-by: Austin Clements <austin@google.com>
* doc: fix typo in Go 1.21 release notesSameer Ajmani2023-04-241-1/+1
| | | | | | | | Change-Id: Ib32567fdd12079cd171a4e1bc118ce27d8ce2a5d Reviewed-on: https://go-review.googlesource.com/c/go/+/488035 Run-TryBot: Sameer Ajmani <sameer@golang.org> Reviewed-by: Damien Neil <dneil@google.com> TryBot-Result: Gopher Robot <gobot@golang.org>
* doc: add release notes for new context functionsDamien Neil2023-04-201-0/+21
| | | | | | | | | | | | For #40221 For #56661 For #57928 Change-Id: Iaf7425bb26eeb9c23235d13c786d5bb572159481 Reviewed-on: https://go-review.googlesource.com/c/go/+/486535 Run-TryBot: Damien Neil <dneil@google.com> Reviewed-by: Sameer Ajmani <sameer@golang.org> TryBot-Result: Gopher Robot <gobot@golang.org>
* doc: correct spelling on placeholderDaniel Frederick Crisman2023-04-131-1/+1
| | | | | | | | | | | | | | | | | "placeholder" (no space) is already used in the spec and seems to be the preferred option. Removed space from "place holder". Change-Id: I9b98f62f0e3f5adb019b99f5271cc9d19abf505e GitHub-Last-Rev: ed5aaf9d02c294e87688066f6218e5d58b0f62bf GitHub-Pull-Request: golang/go#59626 Reviewed-on: https://go-review.googlesource.com/c/go/+/484576 Reviewed-by: Ian Lance Taylor <iant@google.com> TryBot-Result: Gopher Robot <gobot@golang.org> Reviewed-by: Robert Griesemer <gri@google.com> Run-TryBot: Ian Lance Taylor <iant@google.com> Auto-Submit: Ian Lance Taylor <iant@google.com>
* doc: add missing oxford comma in ConstantsDaniel Frederick Crisman2023-04-111-1/+1
| | | | | | | | | | | | | | | | | | | In the language specification under "Constants" the lists matching default types to untyped contstant types is missing an Oxford comma in the first list. I found a number of other places in the spec and #23442 that use the Oxford comma to support its use. Add missing Oxford comma in Constants default type list. Change-Id: I4562d692610334bc82452db076145d2414617a04 GitHub-Last-Rev: 8acdb60d6e255f73fdeb908d2540d4ee35db3fd7 GitHub-Pull-Request: golang/go#59528 Reviewed-on: https://go-review.googlesource.com/c/go/+/483555 TryBot-Result: Gopher Robot <gobot@golang.org> Reviewed-by: Robert Griesemer <gri@google.com> Reviewed-by: Ian Lance Taylor <iant@google.com> Run-TryBot: Ian Lance Taylor <iant@google.com> Auto-Submit: Ian Lance Taylor <iant@google.com>
* doc: fix "are" to "or" in core typescui fliter2023-04-111-1/+1
| | | | | | | | | | | Fixes #59506 Change-Id: I2f8b92e93b706b061ca0eb0bd52e5cf798ce9ede Reviewed-on: https://go-review.googlesource.com/c/go/+/483358 Reviewed-by: Ian Lance Taylor <iant@google.com> TryBot-Bypass: Robert Griesemer <gri@google.com> Reviewed-by: Robert Griesemer <gri@google.com> Auto-Submit: Robert Griesemer <gri@google.com>
* html/template,mime/multipart: document new GODEBUG settingsMichael Anthony Knyszek2023-04-051-1/+13
| | | | | | | | | | | | | | | | | This change documents the new GODEBUG settings introduced for html/template and mime/multipart, released with Go 1.19.8 and Go 1.20.3 as part of a security fix. Updates #59153. Updates #59234. Change-Id: I25f4d8245da3301dccccfb44da8ff1a5985392a4 Reviewed-on: https://go-review.googlesource.com/c/go/+/482238 Auto-Submit: Michael Knyszek <mknyszek@google.com> Reviewed-by: Ian Lance Taylor <iant@golang.org> Run-TryBot: Michael Knyszek <mknyszek@google.com> Reviewed-by: Damien Neil <dneil@google.com> TryBot-Result: Gopher Robot <gobot@golang.org>
* doc: fix template mistake in godebug.mdRuss Cox2023-04-031-0/+2
| | | | | | | | | | | This file is itself template input, so have to hide the template in the go command example. Change-Id: Ifc4eaff35ca8dc2fb479f8e28d64c06b2a9c9d3b Reviewed-on: https://go-review.googlesource.com/c/go/+/480995 Run-TryBot: Russ Cox <rsc@golang.org> TryBot-Result: Gopher Robot <gobot@golang.org> Reviewed-by: Bryan Mills <bcmills@google.com>
* sync: implement OnceFunc, OnceValue, and OnceValuesAustin Clements2023-03-311-0/+12
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This adds the three functions from #56102 to the sync package. These provide a convenient API for the most common uses of sync.Once. The performance of these is comparable to direct use of sync.Once: $ go test -run ^$ -bench OnceFunc\|OnceVal -count 20 | benchstat -row .name -col /v goos: linux goarch: amd64 pkg: sync cpu: 11th Gen Intel(R) Core(TM) i7-1185G7 @ 3.00GHz │ Once │ Global │ Local │ │ sec/op │ sec/op vs base │ sec/op vs base │ OnceFunc 1.3500n ± 6% 2.7030n ± 1% +100.22% (p=0.000 n=20) 0.3935n ± 0% -70.86% (p=0.000 n=20) OnceValue 1.3155n ± 0% 2.7460n ± 1% +108.74% (p=0.000 n=20) 0.5478n ± 1% -58.35% (p=0.000 n=20) The "Once" column represents the baseline of how code would typically express these patterns using sync.Once. "Global" binds the closure returned by OnceFunc/OnceValue to global, which is how I expect these to be used most of the time. Currently, this defeats some inlining opportunities, which roughly doubles the cost over sync.Once; however, it's still *extremely* fast. Finally, "Local" binds the returned closure to a local variable. This unlocks several levels of inlining and represents pretty much the best possible case for these APIs, but is also unlikely to happen in practice. In principle the compiler could recognize that the global in the "Global" case is initialized in place and never mutated and do the same optimizations it does in the "Local" case, but it currently does not. Fixes #56102 Change-Id: If7355eccd7c8de7288d89a4282ff15ab1469e420 Reviewed-on: https://go-review.googlesource.com/c/go/+/451356 TryBot-Result: Gopher Robot <gobot@golang.org> Run-TryBot: Austin Clements <austin@google.com> Reviewed-by: Andrew Gerrand <adg@golang.org> Reviewed-by: Keith Randall <khr@google.com> Reviewed-by: Caleb Spare <cespare@gmail.com> Auto-Submit: Austin Clements <austin@google.com>
* doc: add godebug.md, documenting GODEBUGRuss Cox2023-03-311-0/+181
| | | | | | | | | | | | | | | Document the changes to GODEBUG implemented as part of proposal #56986. Fixes #56986. Change-Id: I23153a123e23820c5b22db4767620e037bbdd083 Reviewed-on: https://go-review.googlesource.com/c/go/+/462202 Reviewed-by: Damien Neil <dneil@google.com> Run-TryBot: Russ Cox <rsc@golang.org> Reviewed-by: Ian Lance Taylor <iant@google.com> TryBot-Result: Gopher Robot <gobot@golang.org> Auto-Submit: Russ Cox <rsc@golang.org>
* runtime: for deep stacks, print both the top 50 and bottom 50 framesAustin Clements2023-03-211-0/+8
| | | | | | | | | | | | | | | | | This is relatively easy using the new traceback iterator. Ancestor tracebacks are now limited to 50 frames. We could keep that at 100, but the fact that it used 100 before seemed arbitrary and unnecessary. Fixes #7181 Updates #54466 Change-Id: If693045881d84848f17e568df275a5105b6f1cb0 Reviewed-on: https://go-review.googlesource.com/c/go/+/475960 Run-TryBot: Austin Clements <austin@google.com> TryBot-Result: Gopher Robot <gobot@golang.org> Reviewed-by: Michael Pratt <mpratt@google.com>
* doc: start draft Go 1.21 release notesThan McIntosh2023-02-221-0/+77
| | | | | | | | | | | | | This initial release notes template is based on previous releases. For #58645. Change-Id: I8bae25d6dd9778a69963b8b4903a6dc1c180e15f Reviewed-on: https://go-review.googlesource.com/c/go/+/470296 Run-TryBot: Than McIntosh <thanm@google.com> TryBot-Result: Gopher Robot <gobot@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
* doc: add clear builtin to specCuong Manh Le2023-02-201-3/+35
| | | | | | | | | | | | | | Fixes #56351 Change-Id: Ia87bf594553b7d0464b591106840f849571c5f39 Reviewed-on: https://go-review.googlesource.com/c/go/+/467755 Auto-Submit: Cuong Manh Le <cuong.manhle.vn@gmail.com> Reviewed-by: Matthew Dempsky <mdempsky@google.com> Run-TryBot: Cuong Manh Le <cuong.manhle.vn@gmail.com> Reviewed-by: Robert Griesemer <gri@google.com> TryBot-Bypass: Robert Griesemer <gri@google.com> Auto-Submit: Robert Griesemer <gri@google.com> TryBot-Result: Gopher Robot <gobot@golang.org>
* doc: do not use "==" in slice examplesCuong Manh Le2023-02-191-10/+10
| | | | | | | | | | | | There's no slice comparison in Go. Change-Id: I5de1766c2adeb56ed12a577a4c46c12b2582b1c8 Reviewed-on: https://go-review.googlesource.com/c/go/+/469015 Reviewed-by: Robert Griesemer <gri@google.com> Run-TryBot: Cuong Manh Le <cuong.manhle.vn@gmail.com> TryBot-Result: Gopher Robot <gobot@golang.org> Auto-Submit: Cuong Manh Le <cuong.manhle.vn@gmail.com> Reviewed-by: Matthew Dempsky <mdempsky@google.com>
* doc: add missing builtin functions not permitted in statement contextCuong Manh Le2023-02-161-2/+2
| | | | | | | | | | | | | The typechecker already enforces this semantic, but the spec is not updated when unsafe.{SliceData,String,StringData} were added. Change-Id: I4ee8c564d5681b2a5fd31ff424a31bdf065d9f3b Reviewed-on: https://go-review.googlesource.com/c/go/+/467756 Auto-Submit: Cuong Manh Le <cuong.manhle.vn@gmail.com> TryBot-Result: Gopher Robot <gobot@golang.org> Run-TryBot: Cuong Manh Le <cuong.manhle.vn@gmail.com> Reviewed-by: Robert Griesemer <gri@google.com> Reviewed-by: Matthew Dempsky <mdempsky@google.com>
* doc: fix spec typoOleksandr Redko2023-02-071-2/+2
| | | | | | | | | | | | Change-Id: I5e3aca2b8fc78f38c9e2cdc67adf86d57ac85b1c GitHub-Last-Rev: 0e5ddffe33f5677449d24e09bdb332e3d5c08aa3 GitHub-Pull-Request: golang/go#58353 Reviewed-on: https://go-review.googlesource.com/c/go/+/465615 Reviewed-by: Robert Griesemer <gri@google.com> Auto-Submit: Ian Lance Taylor <iant@golang.org> Run-TryBot: Ian Lance Taylor <iant@google.com> Reviewed-by: Ian Lance Taylor <iant@google.com> TryBot-Result: Gopher Robot <gobot@golang.org>
* doc: move Go 1.20 release notes to x/websiteMichael Anthony Knyszek2023-01-301-1246/+0
| | | | | | | | | | | | | | | | Now that the development of the Go 1.20 release is almost done, its release notes are moved to their eventual long-term home in x/website in CL 464075. Delete the initial development copy here. For golang/go#54202. Change-Id: Ia402d1abd4539fbce415e2a7dffd6709186f08a7 Reviewed-on: https://go-review.googlesource.com/c/go/+/464055 Auto-Submit: Michael Knyszek <mknyszek@google.com> Reviewed-by: Matthew Dempsky <mdempsky@google.com> TryBot-Result: Gopher Robot <gobot@golang.org> Run-TryBot: Michael Knyszek <mknyszek@google.com> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
* runtime: replace panic(nil) with panic(new(runtime.PanicNilError))Russ Cox2023-01-191-13/+7
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Long ago we decided that panic(nil) was too unlikely to bother making a special case for purposes of recover. Unfortunately, it has turned out not to be a special case. There are many examples of code in the Go ecosystem where an author has written panic(nil) because they want to panic and don't care about the panic value. Using panic(nil) in this case has the unfortunate behavior of making recover behave as though the goroutine isn't panicking. As a result, code like: func f() { defer func() { if err := recover(); err != nil { log.Fatalf("panicked! %v", err) } }() call1() call2() } looks like it guarantees that call2 has been run any time f returns, but that turns out not to be strictly true. If call1 does panic(nil), then f returns "successfully", having recovered the panic, but without calling call2. Instead you have to write something like: func f() { done := false defer func() { if err := recover(); !done { log.Fatalf("panicked! %v", err) } }() call1() call2() done = true } which defeats nearly the whole point of recover. No one does this, with the result that almost all uses of recover are subtly broken. One specific broken use along these lines is in net/http, which recovers from panics in handlers and sends back an HTTP error. Users discovered in the early days of Go that panic(nil) was a convenient way to jump out of a handler up to the serving loop without sending back an HTTP error. This was a bug, not a feature. Go 1.8 added panic(http.ErrAbortHandler) as a better way to access the feature. Any lingering code that uses panic(nil) to abort an HTTP handler without a failure message should be changed to use http.ErrAbortHandler. Programs that need the old, unintended behavior from net/http or other packages can set GODEBUG=panicnil=1 to stop the run-time error. Uses of recover that want to detect panic(nil) in new programs can check for recover returning a value of type *runtime.PanicNilError. Because the new GODEBUG is used inside the runtime, we can't import internal/godebug, so there is some new machinery to cross-connect those in this CL, to allow a mutable GODEBUG setting. That won't be necessary if we add any other mutable GODEBUG settings in the future. The CL also corrects the handling of defaulted GODEBUG values in the runtime, for #56986. Fixes #25448. Change-Id: I2b39c7e83e4f7aa308777dabf2edae54773e03f5 Reviewed-on: https://go-review.googlesource.com/c/go/+/461956 Reviewed-by: Robert Griesemer <gri@google.com> Run-TryBot: Russ Cox <rsc@golang.org> TryBot-Result: Gopher Robot <gobot@golang.org> Auto-Submit: Russ Cox <rsc@golang.org>
* time: revert strict parsing of RFC 3339Joe Tsai2023-01-181-3/+2
| | | | | | | | | | | | | | | | | | | | | | | | CL 444277 fixed Time.UnmarshalText and Time.UnmarshalJSON to properly unmarshal timestamps according to RFC 3339 instead of according to Go's bespoke time syntax that is a superset of RFC 3339. However, this change seems to have broken an AWS S3 unit test that relies on parsing timestamps with single digit hours. It is unclear whether S3 emits these timestamps in production or whether this is simply a testing artifact that has been cargo culted across many code bases. Either way, disable strict parsing for now and re-enable later with better GODEBUG support. Updates #54580 Change-Id: Icced2c7f9a6b2fc06bbd9c7e90f90edce24c2306 Reviewed-on: https://go-review.googlesource.com/c/go/+/462286 Reviewed-by: Bryan Mills <bcmills@google.com> Run-TryBot: Joseph Tsai <joetsai@digital-static.net> TryBot-Result: Gopher Robot <gobot@golang.org> Auto-Submit: Russ Cox <rsc@golang.org> Reviewed-by: Russ Cox <rsc@golang.org> Reviewed-by: Ian Lance Taylor <iant@golang.org>
* doc/go1.20: update cryptography release notesFilippo Valsorda2023-01-171-28/+43
| | | | | | | | | | Change-Id: I5d6d2bd5cbb246ea514e5adbe936fb31b92904af Reviewed-on: https://go-review.googlesource.com/c/go/+/459978 Run-TryBot: Filippo Valsorda <filippo@golang.org> Reviewed-by: Roland Shoemaker <roland@golang.org> Reviewed-by: Cherry Mui <cherryyz@google.com> TryBot-Result: Gopher Robot <gobot@golang.org> Auto-Submit: Filippo Valsorda <filippo@golang.org>
* doc/go1.20: remove mention of arena goexperimentRuss Cox2023-01-171-11/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | The arena goexperiment contains code used inside Google in very limited use cases that we will maintain, but the discussion on #51317 identified serious problems with the very idea of adding arenas to the standard library. In particular the concept tends to infect many other APIs in the name of efficiency, a bit like sync.Pool except more publicly visible. It is unclear when, if ever, we will pick up the idea and try to push it forward into a public API, but it's not going to happen any time soon, and we don't want users to start depending on it: it's a true experiment and may be changed or deleted without warning. The arena text in the release notes makes them seem more official and supported than they really are, and we've already seen a couple blog posts based on that erroneous belief. Delete the text to try to set expectations better. Change-Id: I4f6e328ac470a9cd410f5f722d0769ef62d5e5ba Reviewed-on: https://go-review.googlesource.com/c/go/+/462355 TryBot-Result: Gopher Robot <gobot@golang.org> Reviewed-by: Austin Clements <austin@google.com> Run-TryBot: Russ Cox <rsc@golang.org> Auto-Submit: Russ Cox <rsc@golang.org> Reviewed-by: Eli Bendersky <eliben@google.com>
* doc/go1.20: mention build speed improvementsAustin Clements2023-01-131-2/+4
| | | | | | | | | | For #49569. For #54202. Change-Id: Iac45338bc4e45617e8ac7425076cf4cd0af157a4 Reviewed-on: https://go-review.googlesource.com/c/go/+/461957 TryBot-Bypass: Austin Clements <austin@google.com> Reviewed-by: Michael Knyszek <mknyszek@google.com>
* doc/go1.20: fix links to new strings functionsPiers2023-01-041-4/+4
| | | | | | | | | | | | | | Links under strings package were linking to the bytes versions of the functions. Change-Id: If6ebe37fede8e417f8683695783aa767bc01e9c7 GitHub-Last-Rev: 8849285122cb58c17b5979144649075861d8a134 GitHub-Pull-Request: golang/go#57579 Reviewed-on: https://go-review.googlesource.com/c/go/+/460458 TryBot-Result: Gopher Robot <gobot@golang.org> Run-TryBot: Ian Lance Taylor <iant@google.com> Reviewed-by: Heschi Kreinick <heschi@google.com> Reviewed-by: Ian Lance Taylor <iant@google.com> Auto-Submit: Ian Lance Taylor <iant@google.com>
* doc/go1.20: fix http.ResponseController exampleAlexander Yastrebov2023-01-031-1/+1
| | | | | | | | | | | | | | | Fixes #57162 Change-Id: I190810d702e503822265b12c56db69ec1093233c GitHub-Last-Rev: e8b259d4b37523f1992fb92d99cbe068ab070eb2 GitHub-Pull-Request: golang/go#57385 Reviewed-on: https://go-review.googlesource.com/c/go/+/458275 Reviewed-by: Dmitri Shuralyov <dmitshur@google.com> Auto-Submit: Dmitri Shuralyov <dmitshur@google.com> Reviewed-by: Matt Layher <mdlayher@gmail.com> TryBot-Result: Gopher Robot <gobot@golang.org> Run-TryBot: Dmitri Shuralyov <dmitshur@google.com> Reviewed-by: Heschi Kreinick <heschi@google.com>
* doc/go1.20: fix typosXiao Cui2022-12-291-2/+2
| | | | | | | | | | Change-Id: Ie2e583cba9e9bec7d642e323e77fb2d9b05dc7bc Reviewed-on: https://go-review.googlesource.com/c/go/+/459780 Reviewed-by: Dmitri Shuralyov <dmitshur@google.com> Auto-Submit: Ian Lance Taylor <iant@google.com> Run-TryBot: Ian Lance Taylor <iant@google.com> TryBot-Result: Gopher Robot <gobot@golang.org> Reviewed-by: Ian Lance Taylor <iant@google.com>
* doc/go1.20: fix typoTobias Klauser2022-12-221-1/+1
| | | | | | | | | | | | Change-Id: Ia0ce728ca18eefd835220b2076c4aa8ba00cda6d Reviewed-on: https://go-review.googlesource.com/c/go/+/458815 Run-TryBot: Tobias Klauser <tobias.klauser@gmail.com> Reviewed-by: Ian Lance Taylor <iant@google.com> Auto-Submit: Ian Lance Taylor <iant@google.com> TryBot-Result: Gopher Robot <gobot@golang.org> Run-TryBot: Ian Lance Taylor <iant@google.com> Auto-Submit: Tobias Klauser <tobias.klauser@gmail.com> Reviewed-by: David Chase <drchase@google.com>
* doc/go1.20: fix typoRobert Griesemer2022-12-151-1/+1
| | | | | | | | | Change-Id: Icddf980e533b86ca955660ad028f5ad04b6aecbe Reviewed-on: https://go-review.googlesource.com/c/go/+/457916 Auto-Submit: Robert Griesemer <gri@google.com> Reviewed-by: Robert Griesemer <gri@google.com> TryBot-Bypass: Robert Griesemer <gri@google.com> Reviewed-by: Than McIntosh <thanm@google.com>
* spec: fix typoRobert Griesemer2022-12-151-2/+2
| | | | | | | | | | | Fixes #57323. Change-Id: I77d3d747aa4746bb9a8cca0c0500ff8fa6ae33a3 Reviewed-on: https://go-review.googlesource.com/c/go/+/457915 Reviewed-by: Robert Griesemer <gri@google.com> TryBot-Bypass: Robert Griesemer <gri@google.com> Auto-Submit: Robert Griesemer <gri@google.com> Reviewed-by: Than McIntosh <thanm@google.com>
* spec: document which recursive arrays and structs are valid/invalidRobert Griesemer2022-12-141-5/+56
| | | | | | | | | | | Fixes #5069. Change-Id: I4bc0f52a9cd1e64a49846dffeb4be5cbecc29a96 Reviewed-on: https://go-review.googlesource.com/c/go/+/457342 TryBot-Bypass: Robert Griesemer <gri@google.com> Reviewed-by: Rob Pike <r@golang.org> Reviewed-by: Robert Griesemer <gri@google.com> Reviewed-by: Robert Findley <rfindley@google.com>
* doc/go1.20.html: pre-announce dropping Windows 7, 8, and friendsHeschi Kreinick2022-12-141-1/+8
| | | | | | | | | | | | For #57003, #57004. Change-Id: Ic1386a0ce83897411fbc68c83a9125af1cc11b54 Reviewed-on: https://go-review.googlesource.com/c/go/+/457695 Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@google.com> Auto-Submit: Heschi Kreinick <heschi@google.com> Run-TryBot: Heschi Kreinick <heschi@google.com> TryBot-Result: Gopher Robot <gobot@golang.org>
* spec: document illegal recursive type parameter listsRobert Griesemer2022-12-141-4/+15
| | | | | | | | | | Fixes #40882. Change-Id: I90f99d75e6d66f857b6ab8789c6d436f85d20993 Reviewed-on: https://go-review.googlesource.com/c/go/+/457515 TryBot-Bypass: Robert Griesemer <gri@google.com> Reviewed-by: Ian Lance Taylor <iant@google.com> Reviewed-by: Robert Findley <rfindley@google.com>
* spec: describe new semantics for comparable and constraint satisfactionRobert Griesemer2022-12-141-23/+57
| | | | | | | | | | | | For #56548. Fixes #57012. Change-Id: I44f850522e52b1811025fb31bcef289da8f8089d Reviewed-on: https://go-review.googlesource.com/c/go/+/457437 TryBot-Bypass: Robert Griesemer <gri@google.com> Reviewed-by: Ian Lance Taylor <iant@google.com> Reviewed-by: Robert Findley <rfindley@google.com> Reviewed-by: Robert Griesemer <gri@google.com>
* spec: introduce notion of strict comparabilityRobert Griesemer2022-12-141-27/+57
| | | | | | | | | | | | | | | | | | | | | | | | - Rephrase the notion of "comparability" from a property of values (operands) to a property of types and adjust dependent prose. - Introduce the notion of "strict comparability". - Fix the definitions of comparability for type interfaces and type parameters. - Define the predeclared identifier "comparable" as stricly comparable. These changes address existing problems in the spec as outlined in the section on "Related spec issues" in issue #56548. For #56548. Change-Id: Ibc8c2f36d92857a5134eadc18358624803d3dd21 Reviewed-on: https://go-review.googlesource.com/c/go/+/457095 Reviewed-by: Ian Lance Taylor <iant@google.com> Reviewed-by: Matthew Dempsky <mdempsky@google.com> TryBot-Bypass: Robert Griesemer <gri@google.com> Reviewed-by: Robert Findley <rfindley@google.com> Reviewed-by: Robert Griesemer <gri@google.com>
* doc/go1.20: fix typoAlexander Frolov2022-12-121-1/+1
| | | | | | | | | | | | Change-Id: Id0319a9cc9acc549022fdcd6b7d71c7343afd245 GitHub-Last-Rev: 2b84d25763c3f8a03663d4ba75cefa4a372fefbd GitHub-Pull-Request: golang/go#57187 Reviewed-on: https://go-review.googlesource.com/c/go/+/456395 Run-TryBot: Ian Lance Taylor <iant@google.com> Auto-Submit: Ian Lance Taylor <iant@google.com> TryBot-Result: Gopher Robot <gobot@golang.org> Reviewed-by: Ian Lance Taylor <iant@google.com> Reviewed-by: Than McIntosh <thanm@google.com>
* doc/go1.20: fix URL anchorShengyu Zhang2022-12-121-1/+1
| | | | | | | | | | | | | | | The URL anchor was invalid. Add the missing "array_or_" part. Change-Id: Ib27f4d0f21b0148bea8b63ef962ba0ea30166ed3 GitHub-Last-Rev: f8addc607812290ebbdbb1560f336f56390d0d8d GitHub-Pull-Request: golang/go#57154 Reviewed-on: https://go-review.googlesource.com/c/go/+/456175 Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org> Reviewed-by: Than McIntosh <thanm@google.com> Reviewed-by: Dmitri Shuralyov <dmitshur@google.com> Run-TryBot: Dmitri Shuralyov <dmitshur@golang.org> TryBot-Result: Gopher Robot <gobot@golang.org> Auto-Submit: Dmitri Shuralyov <dmitshur@golang.org>
* doc: fix typo in 1.20 release notesThan McIntosh2022-12-091-1/+1
| | | | | | | | | | Fix typo. Change-Id: Id3a78ac5d8ea429ba1685889cd1661aaca8572c5 Reviewed-on: https://go-review.googlesource.com/c/go/+/456238 Run-TryBot: Than McIntosh <thanm@google.com> TryBot-Result: Gopher Robot <gobot@golang.org> Reviewed-by: Ian Lance Taylor <iant@google.com>
* doc: fix typoZhizhen He2022-12-081-1/+1
| | | | | | | | | | | | Change-Id: Ie639fe39b83336c0d885cdcb2fddc06f2b06c2dd GitHub-Last-Rev: b5cc78ad42ee57d77cf027cc5fb6840eb38a0f1b GitHub-Pull-Request: golang/go#57082 Reviewed-on: https://go-review.googlesource.com/c/go/+/455196 Run-TryBot: Dmitri Shuralyov <dmitshur@golang.org> Reviewed-by: Robert Griesemer <gri@google.com> TryBot-Result: Gopher Robot <gobot@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@google.com> Auto-Submit: Dmitri Shuralyov <dmitshur@golang.org>
* doc/go1.20: correct test binary -v flag value for test2jsonDmitri Shuralyov2022-12-081-3/+3
| | | | | | | | | | | | | | | | The -v flag value is "test2json", not "json", since it emits output in a custom format that the cmd/test2json tool interprets. The cmd/test2json documentation and implementation have this right. For #54202. Change-Id: I2b52861d926e14488aa9fc89fff8c26da32ca710 Reviewed-on: https://go-review.googlesource.com/c/go/+/456124 Reviewed-by: Bryan Mills <bcmills@google.com> Auto-Submit: Dmitri Shuralyov <dmitshur@golang.org> TryBot-Result: Gopher Robot <gobot@golang.org> Run-TryBot: Dmitri Shuralyov <dmitshur@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
* doc/go1.20: delete remaining TODOMichael Pratt2022-12-071-4/+0
| | | | | | | | | | | | This section is complete. For #54202. Change-Id: I304cc55a5b8ed53e8b8dff73a5feb5ef39207846 Reviewed-on: https://go-review.googlesource.com/c/go/+/455895 Run-TryBot: Michael Pratt <mpratt@google.com> Reviewed-by: Carlos Amedee <carlos@golang.org> TryBot-Result: Gopher Robot <gobot@golang.org>
* doc/go1.20: add section on coverageThan McIntosh2022-12-071-1/+28
| | | | | | | | | | | | | | Add some basic material on the changes to code coverage testing to the release notes. For #54202. Change-Id: I28200d43b4952ce8e8ecf46c8fe8e97c81d245e5 Reviewed-on: https://go-review.googlesource.com/c/go/+/453857 TryBot-Result: Gopher Robot <gobot@golang.org> Run-TryBot: Than McIntosh <thanm@google.com> Reviewed-by: Eli Bendersky <eliben@google.com> Reviewed-by: Cherry Mui <cherryyz@google.com>
* doc/go1.20: relnote and take care of TODOsRuss Cox2022-12-071-2/+19
| | | | | | | | | | The main change here is documenting the last-minute addition types.Satisfies. Change-Id: I8be2d2ad730ba108706bd849b68cbd1f4d68a4b8 Reviewed-on: https://go-review.googlesource.com/c/go/+/455698 Run-TryBot: Russ Cox <rsc@golang.org> TryBot-Result: Gopher Robot <gobot@golang.org> Reviewed-by: Heschi Kreinick <heschi@google.com>
* doc: 1.20 compiler changesDavid Chase2022-12-051-1/+12
| | | | | | | | | | | | | | | This adds the nonPGO, non-coverage compiler changes for the 1.20 release. There's not that much user visible change. For #54202. Change-Id: Ib2964ed5f7e73bb89c720d09b868ab79682f5070 Reviewed-on: https://go-review.googlesource.com/c/go/+/454536 TryBot-Result: Gopher Robot <gobot@golang.org> Reviewed-by: Keith Randall <khr@golang.org> Reviewed-by: Cherry Mui <cherryyz@google.com> Run-TryBot: David Chase <drchase@google.com>
* doc/go1.20: preannounce dropping macOS 10.13 and 10.14 supportHeschi Kreinick2022-12-021-0/+7
| | | | | | | | | | | For #23011. Change-Id: I386920928a98403180098f1da5ea7696a239210e Reviewed-on: https://go-review.googlesource.com/c/go/+/454957 Auto-Submit: Heschi Kreinick <heschi@google.com> Reviewed-by: Carlos Amedee <carlos@golang.org> TryBot-Result: Gopher Robot <gobot@golang.org> Run-TryBot: Heschi Kreinick <heschi@google.com>
* doc/go1.20: resolve root bundle package TODORoland Shoemaker2022-12-021-1/+2
| | | | | | | | | | | | | | | | We're unlikely to get this package out of the door all that soon. For now add a note that SetFallbackRoots will be most commonly used with an TBA package, and link the tracking issue. We could also just remove the "It will most commonly be used ..." sentence. Change-Id: Ie96134d757f5b4c69f1878d53c92b5ed602671e4 Reviewed-on: https://go-review.googlesource.com/c/go/+/454056 Reviewed-by: Julie Qiu <julieqiu@google.com> Run-TryBot: Roland Shoemaker <roland@golang.org> TryBot-Result: Gopher Robot <gobot@golang.org> Auto-Submit: Roland Shoemaker <roland@golang.org>
* doc/go1.20: add code tags in crypto/{rsa,subtle} and net/netip sectionsTobias Klauser2022-12-011-4/+4
| | | | | | | | | | Change-Id: I516195fb1c2434feb3bf130d37012a98d77beeb6 Reviewed-on: https://go-review.googlesource.com/c/go/+/454235 Run-TryBot: Tobias Klauser <tobias.klauser@gmail.com> Reviewed-by: Russ Cox <rsc@golang.org> Auto-Submit: Tobias Klauser <tobias.klauser@gmail.com> Reviewed-by: Ian Lance Taylor <iant@google.com> TryBot-Result: Gopher Robot <gobot@golang.org>
* doc: add release note for cgo.IncompleteCuong Manh Le2022-12-011-2/+9
| | | | | | | | | | | | Updates #46731 Change-Id: Ie64e87d759c48642582342d221b24f77bb81d47a Reviewed-on: https://go-review.googlesource.com/c/go/+/453556 Auto-Submit: Cuong Manh Le <cuong.manhle.vn@gmail.com> TryBot-Result: Gopher Robot <gobot@golang.org> Run-TryBot: Cuong Manh Le <cuong.manhle.vn@gmail.com> Reviewed-by: Russ Cox <rsc@golang.org> Reviewed-by: Ian Lance Taylor <iant@google.com>
* doc/go1.20: document new semantics for comparable constraintRobert Griesemer2022-12-011-1/+10
| | | | | | | | | | | | For #54202. For #56548. Change-Id: If2b9e41813c3e1c8d373469a40e1bd0bd5ea2b16 Reviewed-on: https://go-review.googlesource.com/c/go/+/454595 Reviewed-by: Ian Lance Taylor <iant@golang.org> Reviewed-by: Ian Lance Taylor <iant@google.com> TryBot-Bypass: Robert Griesemer <gri@google.com> Reviewed-by: Robert Griesemer <gri@google.com>
* doc/go1.20: add runtime, runtime/trace, and runtime/pprof release notesMichael Anthony Knyszek2022-11-301-4/+51
| | | | | | | | | | | | | | | | | This change adds release notes for the "Runtime" section and updated some of the release notes for runtime/trace and runtime/pprof after I looked at the full list of runtime-related changes. For #54202. Change-Id: Id1395f4e6e02d3fcc248855ca98ad0ee26cae574 Reviewed-on: https://go-review.googlesource.com/c/go/+/454075 TryBot-Result: Gopher Robot <gobot@golang.org> Reviewed-by: Cherry Mui <cherryyz@google.com> Reviewed-by: Robert Griesemer <gri@google.com> Reviewed-by: Austin Clements <austin@google.com> Run-TryBot: Michael Knyszek <mknyszek@google.com> Auto-Submit: Michael Knyszek <mknyszek@google.com>