Skip to content

Commit 9dcf419

Browse files
dmitshurgopherbot
authored andcommitted
doc/next: update with reviewed output from relnote todo
This is the result of running relnote todo today and reviewing its output. Most of the remaining items that still need to be added to Go 1.24 release notes are now tracked in release blocking issues. For a few where it's less clear, I opted to comment on issues. A good number of items were proposals that affect golang.org/x repos and don't need to be mentioned in Go 1.24 release notes; they're now annotated as such. For #68545. Change-Id: I4dc7f6d2cf5ab9e68bce83d01413224f80384e2f Reviewed-on: https://go-review.googlesource.com/c/go/+/631684 LUCI-TryBot-Result: Go LUCI <[email protected]> Reviewed-by: Cherry Mui <[email protected]> Auto-Submit: Dmitri Shuralyov <[email protected]> Reviewed-by: Dmitri Shuralyov <[email protected]>
1 parent 7e09508 commit 9dcf419

File tree

3 files changed

+72
-0
lines changed

3 files changed

+72
-0
lines changed

doc/next/3-tools.md

+6
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@
22

33
### Go command {#go-command}
44

5+
<!-- go.dev/issue/62067 -->
56
The `go build` and `go install` commands now accept a `-json` flag that reports
67
build output and failures as structured JSON output on standard output.
78
For details of the reporting format, see `go help buildjson`.
@@ -14,6 +15,7 @@ a test integration system, you can revert to the text build output by setting
1415

1516
### Cgo {#cgo}
1617

18+
<!-- go.dev/issue/56378 -->
1719
Cgo supports new annotations for C functions to improve run time
1820
performance.
1921
`#cgo noescape cFunctionName` tells the compiler that memory passed to
@@ -22,6 +24,7 @@ the C function `cFunctionname` does not escape.
2224
`cFunctionName` does not call back to any Go functions.
2325
For more information, see [the cgo documentation](/pkg/cmd/cgo#hdr-Optimizing_calls_of_C_code).
2426

27+
<!-- go.dev/issue/67699 -->
2528
Cgo currently refuses to compile calls to a C function which has multiple
2629
incompatible declarations. For instance, if `f` is declared as both `void f(int)`
2730
and `void f(double)`, cgo will report an error instead of possibly generating an
@@ -31,13 +34,15 @@ files. See [#67699](/issue/67699).
3134

3235
### Vet
3336

37+
<!-- go.dev/issue/44251 -->
3438
The new `tests` analyzer reports common mistakes in declarations of
3539
tests, fuzzers, benchmarks, and examples in test packages, such as
3640
malformed names, incorrect signatures, or examples that document
3741
non-existent identifiers. Some of these mistakes may cause tests not
3842
to run.
3943
This analyzer is among the subset of analyzers that are run by `go test`.
4044

45+
<!-- go.dev/issue/60529 -->
4146
The existing `printf` analyzer now reports a diagnostic for calls of
4247
the form `fmt.Printf(s)`, where `s` is a non-constant format string,
4348
with no other arguments. Such calls are nearly always a mistake
@@ -46,6 +51,7 @@ See [#60529](/issue/60529).
4651

4752
### GOCACHEPROG
4853

54+
<!-- go.dev/issue/64876 -->
4955
The `cmd/go` internal binary and test caching mechanism can now be implemented
5056
by child processes implementing a JSON protocol between the `cmd/go` tool
5157
and the child process named by the `GOCACHEPROG` environment variable.

doc/next/7-ports.md

+2
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@
22

33
### Linux {#linux}
44

5+
<!-- go.dev/issue/67001 -->
56
As [announced](go1.23#linux) in the Go 1.23 release notes, Go 1.24 requires Linux
67
kernel version 3.2 or later.
78

@@ -13,4 +14,5 @@ Go 1.25 will require macOS 12 Monterey or later.
1314

1415
### WebAssembly {#wasm}
1516

17+
<!-- go.dev/issue/68024 -->
1618
The support files for WebAssembly have been moved to `lib/wasm` from `misc/wasm`.

doc/next/9-todo.md

+64
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
<!--
2+
Output from relnote todo that was generated and reviewed on 2024-11-26:
3+
4+
CL 579955 has a RELNOTE comment without a suggested text (from RELNOTE comment in https://go.dev/cl/579955) - handled below
5+
CL 603055 has a RELNOTE comment without a suggested text (from RELNOTE comment in https://go.dev/cl/603055) - handled below
6+
CL 618598 has a RELNOTE comment without a suggested text (from RELNOTE comment in https://go.dev/cl/618598) - generating LC_UUID in Go linker for macOS 15 is now tracked in issue 68678 itself as a release blocker
7+
CL 618601 has a RELNOTE comment without a suggested text (from RELNOTE comment in https://go.dev/cl/618601) - on ELF, GNU build ID being generated by default is now tracked in a new release-blocking issue 70586
8+
accepted proposal https://go.dev/issue/25309 (from https://go.dev/cl/594018, https://go.dev/cl/595120, https://go.dev/cl/595564, https://go.dev/cl/601778) - new x/crypto package; doesn't seem to need to be mentioned but asked anyway in https://go.dev/issue/25309#issuecomment-2498747653
9+
accepted proposal https://go.dev/issue/26232 (from https://go.dev/cl/605256, https://go.dev/cl/605275, https://go.dev/cl/605298, https://go.dev/cl/625036) - cmd/go's HTTP auth is tracked in proposal 26232 itself as a release blocker
10+
accepted proposal https://go.dev/issue/34208 (from https://go.dev/cl/586241) - CL 586241 implements a fix for a Go 1.23 feature, doesn't seem to be need anything in Go 1.24 release notes
11+
accepted proposal https://go.dev/issue/38445 (from https://go.dev/cl/626495) - proposal 38445 is about x/tools/go/package, doesn't need anything in Go 1.24 release notes
12+
accepted proposal https://go.dev/issue/41682 (from https://go.dev/cl/629676) - x509sha1 godebug being removed is covered in doc/next/6-stdlib/99-minor/crypto/x509/41682.md
13+
accepted proposal https://go.dev/issue/43744 (from https://go.dev/cl/357530) - unclear if Go 1.24 release notes need anything; pinged it in https://go.dev/issue/43744#issuecomment-2498773718
14+
accepted proposal https://go.dev/issue/43993 (from https://go.dev/cl/626116) - CL 626116 prepares the tree towards the vet change but the vet change itself isn't implemented in Go 1.24, so nothing to say in Go 1.24 release notes
15+
accepted proposal https://go.dev/issue/44251 (from https://go.dev/cl/603476) - new tests analyzer is covered in 3-tools.md
16+
accepted proposal https://go.dev/issue/44505 (from https://go.dev/cl/609955) - CL 609955 is an internal cleanup in x/tools, no need for Go 1.24 release note
17+
accepted proposal https://go.dev/issue/46477 (from https://go.dev/cl/601115, https://go.dev/cl/601235, https://go.dev/cl/614638, https://go.dev/cl/616816) - permitting type parameters on aliases is tracked in proposal 46477 itself as a release blocker
18+
accepted proposal https://go.dev/issue/48429 (from https://go.dev/cl/521958, https://go.dev/cl/521959, https://go.dev/cl/534817, https://go.dev/cl/563175, https://go.dev/cl/613095, https://go.dev/cl/614555, https://go.dev/cl/630695) - cmd/go support for tracking tool dependencies in go.mod is tracked in proposal 48429 itself as a release blocker
19+
accepted proposal https://go.dev/issue/50603 (from https://go.dev/cl/595376, https://go.dev/cl/596035, https://go.dev/cl/609155, https://go.dev/cl/611916, https://go.dev/cl/627295) - cmd/go support for stamping pseudo-version in go build is tracked in proposal 50603 itself as a release blocker
20+
accepted proposal https://go.dev/issue/51269 (from https://go.dev/cl/627035) - may be worth mentioning in Go 1.24 release notes, or may be fine to leave out; commented at https://go.dev/issue/51269#issuecomment-2501802763
21+
accepted proposal https://go.dev/issue/51430 (from https://go.dev/cl/613375) - CL 613375 is an internal documentation comment; proposal 51430 happened in Go 1.20/1.21 so nothing more is needed in Go 1.24 release notes
22+
accepted proposal https://go.dev/issue/53021 (from https://go.dev/cl/622276) - CL 622276 improves docs; proposal 53021 was in Go 1.20 so nothing more is needed in Go 1.24 release notes
23+
accepted proposal https://go.dev/issue/54265 (from https://go.dev/cl/609915, https://go.dev/cl/610675) - CLs that refer to a Go 1.22 proposal, nothing more is needed in Go 1.24 release notes
24+
accepted proposal https://go.dev/issue/56378 (from https://go.dev/cl/579955) - mentioning that #cgo noescape/nocallback directives are available in Go 1.24 is now tracked in proposal 56378 itself as a release blocker; now done in CL 632015
25+
accepted proposal https://go.dev/issue/56986 (from https://go.dev/cl/618115) - CL 618115 adds documentation; it doesn't need to be mentioned in Go 1.24 release notes
26+
accepted proposal https://go.dev/issue/57786 (from https://go.dev/cl/472717) - CL 472717 is in x/net/http2 and mentions a Go 1.21 proposal; it doesn't seem to need anything in Go 1.24 release notes
27+
accepted proposal https://go.dev/issue/60061 (from https://go.dev/cl/612038) - CL 612038 is a CL that deprecates something in x/tools/go/ast and mentions a Go 1.22 proposal; doesn't need anything in Go 1.24 release notes
28+
accepted proposal https://go.dev/issue/60529 (from https://go.dev/cl/585795, https://go.dev/cl/610795) - new vet check that reports printf calls with non-const format and no args needs to be mentioned in Go 1.24 release notes and is tracked in proposal 60529 itself as a release blocker; now done in CL 631682
29+
accepted proposal https://go.dev/issue/60905 (from https://go.dev/cl/610195) - CL 610195 seems like a small performance enhancement that builds on the Go 1.23 proposal to add GOARM64; probably okay without being mentioned in Go 1.24 release notes (also probably okay to mention)
30+
accepted proposal https://go.dev/issue/61324 (from https://go.dev/cl/411907) - CL 411907 is an x/tools CL that implements a proposal for a new package there; doesn't need anything in Go 1.24 release notes
31+
accepted proposal https://go.dev/issue/61395 (from https://go.dev/cl/594738, https://go.dev/cl/594976) - CL 594738 made sync/atomic AND/OR operations intrinsic on amd64, but the API was already added in Go 1.23; CL 594976 is a fix; probably doesn't require a Go 1.24 release note
32+
accepted proposal https://go.dev/issue/61417 (from https://go.dev/cl/605955) - a new field in x/oauth2; nothing to mention in Go 1.24 release notes
33+
accepted proposal https://go.dev/issue/61476 (from https://go.dev/cl/608255) - CL 608255 builds on GORISCV64 added in Go 1.23; nothing to mention in Go 1.24 release notes
34+
accepted proposal https://go.dev/issue/61777 (from https://go.dev/cl/601496) - CL 601496 added a WriteByteTimeout field to x/net/http2.Server; doesn't need a Go 1.24 release note
35+
accepted proposal https://go.dev/issue/61940 (from https://go.dev/cl/600997) - CL 600997 deleted obsolete code in x/build and mentioned an accepted proposal; doesn't need a Go 1.24 release note
36+
accepted proposal https://go.dev/issue/62067 (from https://go.dev/cl/536396, https://go.dev/cl/536397, https://go.dev/cl/536398, https://go.dev/cl/536399, https://go.dev/cl/558637, https://go.dev/cl/628955, https://go.dev/cl/629335) - go build -json is covered in 3-tools.md
37+
accepted proposal https://go.dev/issue/62113 (from https://go.dev/cl/594195) - CL 594195 made iterator-related additions in x/net/html; doesn't need a Go 1.24 release note
38+
accepted proposal https://go.dev/issue/62484 (from https://go.dev/cl/600775) - CL 600775 documents CopyFS symlink behavior and mentions the Go 1.23 proposal; doesn't need a Go 1.24 release note
39+
accepted proposal https://go.dev/issue/64127 (from https://go.dev/cl/597576) - mentioning the new vet check to report invalid Go versions in build tags is tracked in proposal 64127 itself as a release blocker
40+
accepted proposal https://go.dev/issue/64207 (from https://go.dev/cl/605875) - an x/website CL that follows up on a Go 1.23 proposal; doesn't need a Go 1.24 release note
41+
accepted proposal https://go.dev/issue/64802 (from https://go.dev/cl/628681) - a crypto/ecdsa change when rand is nil; commented at https://go.dev/issue/64802#issuecomment-2502019212 for next steps
42+
accepted proposal https://go.dev/issue/64876 (from https://go.dev/cl/626035) - cmd/go's GOCACHEPROG being promoted out of experiment is covered in 3-tools.md
43+
accepted proposal https://go.dev/issue/65199 (from https://go.dev/cl/603055, https://go.dev/cl/603836, https://go.dev/cl/604316, https://go.dev/cl/604975, https://go.dev/cl/606855, https://go.dev/cl/611315) - the new go:wasmexport directive is now tracked in proposal 65199 itself as a release blocker
44+
accepted proposal https://go.dev/issue/65236 (from https://go.dev/cl/596135) - CL 596135 adds tests for the Go 1.23 proposal 65236; doesn't need a Go 1.24 release note
45+
accepted proposal https://go.dev/issue/65269 (from https://go.dev/cl/602855, https://go.dev/cl/616717, https://go.dev/cl/629176) - new standard library package crypto/sha3 package is covered in 6-stdlib/5-sha3.md
46+
accepted proposal https://go.dev/issue/66315 (from https://go.dev/cl/577996) - adding Pass.Module field to x/tools/go/analysis doesn't seem like something that needs to be mentioned in Go 1.24 release notes
47+
accepted proposal https://go.dev/issue/66387 (from https://go.dev/cl/569955) - extending the copylock analyzer in cmd/vet is now tracked in proposal 66387 itself as a release blocker
48+
accepted proposal https://go.dev/issue/66540 (from https://go.dev/cl/603958) - a Go language spec clarification; might not need to be mentioned in Go 1.24 release notes; left a comment at https://go.dev/issue/66540#issuecomment-2502051684
49+
accepted proposal https://go.dev/issue/66821 (from https://go.dev/cl/602495, https://go.dev/cl/602497, https://go.dev/cl/608175, https://go.dev/cl/608435, https://go.dev/cl/621979, https://go.dev/cl/622115) - crashing the process on error reading randomness (which should not have a path to happen) might need to be mentioned; commented at https://go.dev/issues/66821#issuecomment-2502069725 for next steps
50+
accepted proposal https://go.dev/issue/66984 (from https://go.dev/cl/626615, https://go.dev/cl/627059) - relaxation of wasm function import signature type constraints might be something to mention in Go 1.24 release notes; commented at https://go.dev/issue/66984#issuecomment-2502079735 for next steps
51+
accepted proposal https://go.dev/issue/67001 (from https://go.dev/cl/588216, https://go.dev/cl/602495, https://go.dev/cl/608175, https://go.dev/cl/609178, https://go.dev/cl/611943, https://go.dev/cl/622015) - Linux 3.2 kernel requirement is covered in 7-ports.md
52+
accepted proposal https://go.dev/issue/67675 (from https://go.dev/cl/630995) - ability to generate a serial number via nil template.SerialNumber is now tracked in proposal 67675 itself as a release blocker; now done in CL 631683
53+
accepted proposal https://go.dev/issue/67795 (from https://go.dev/cl/616218) - iteratior support for x/tools/go/ast/inspector; doesn't need a Go 1.24 release note
54+
accepted proposal https://go.dev/issue/67812 (from https://go.dev/cl/601497) - configurable server pings for x/net/http2.Server; doesn't need a Go 1.24 release note
55+
accepted proposal https://go.dev/issue/68232 (from https://go.dev/cl/595676) - x/sys/unix additions; doesn't need a Go 1.24 release note
56+
accepted proposal https://go.dev/issue/68384 (from https://go.dev/cl/611875) - expanding the scope of Go Telemetry to include Delve isn't directly tied to Go 1.24 and doesn't seem to need to be mentioned in Go 1.24 release notes
57+
accepted proposal https://go.dev/issue/68898 (from https://go.dev/cl/607495, https://go.dev/cl/620036, https://go.dev/cl/620135, https://go.dev/cl/623638) - a proposal for x/tools/go/gcexportdata to document 2 releaes + tip support policy; since the change is in x/tools it doesn't need a Go 1.24 release note
58+
accepted proposal https://go.dev/issue/69095 (from https://go.dev/cl/593683, https://go.dev/cl/608955, https://go.dev/cl/610716) - a proposal that affects maintenance and support of golang.org/x repositories; doesn't need to be mentioned in Go 1.24 release notes
59+
accepted proposal https://go.dev/issue/69290 (from https://go.dev/cl/613095) - cmd/go caching link output binaries is now tracked in proposal 69290 itself as a release blocker
60+
accepted proposal https://go.dev/issue/69291 (from https://go.dev/cl/610939) - CL 610939 refactors code in x/tools and mentions the still-open proposal #69291 to add Reachable to x/tools/go/ssa/ssautil; doesn't need a Go 1.24 release note
61+
accepted proposal https://go.dev/issue/69360 (from https://go.dev/cl/614158, https://go.dev/cl/614159, https://go.dev/cl/614635, https://go.dev/cl/614675) - proposal 69360 is to tag and delete gorename from x/tools; doesn't need a Go 1.24 release note
62+
accepted proposal https://go.dev/issue/69393 (from https://go.dev/cl/630775) - automatic crypto/tls.CurvePreferences ordering is now tracked in proposal 69393 itself as a release blocker
63+
accepted proposal https://go.dev/issue/69687 (from https://go.dev/cl/591997, https://go.dev/cl/629735) - experimental package testing/synctest behind an experiment; commented at https://github.com/golang/go/issues/69687#issuecomment-2502179333, leaving to Damien to decide whether to document it or defer that until the package is added as non-experiment
64+
-->

0 commit comments

Comments
 (0)