Merge pull request #61 from golang/master

[pull] master from golang:master

Author: pull[bot]

doc/next/9-todo.md

@@ -0,0 +1,183 @@
+## TODO
+Please convert these into documentation in the right places.
+Some of them may not need any documentation or may be false
+positives from automation.
+
+### TODO: CL 734540 has a RELNOTE comment without a suggested text (from RELNOTE comment in /cl/734540)
+- `all: switch linux-ppc64 target to ELFv2 ABI`
+
+### TODO: CL 751260 has a RELNOTE comment without a suggested text (from RELNOTE comment in /cl/751260)
+- `cmd/link: add -macos and -macsdk flags to set LC_BUILD_VERSION`
+
+### TODO: CL 774621 has a RELNOTE comment without a suggested text (from RELNOTE comment in /cl/774621)
+- `internal/goexperiment,runtime: drop goroutineleakprofile experiment`
+
+### TODO: accepted proposal /issue/17747 (from /cl/730480, /cl/783961)
+- `cmd/vet: check for missing Err calls for bufio.Scanner [done] and sql.Rows [done]`
+- `go/analysis/passes/scannererr: report failure to check bufio.Scanner.Err`
+- `go/analysis/passes/sqlrowserr: report missing sql.Rows.Err calls`
+
+### TODO: accepted proposal /issue/26715 (from /cl/445116)
+- `cmd/doc: add example support`
+- `cmd/go: add example support to go doc output`
+
+### TODO: accepted proposal /issue/32958 (from /cl/733040)
+- `x/crypto/ssh: add NewControlClientConn`
+- `ssh: add openssh controlmaster socket support`
+
+### TODO: accepted proposal /issue/35487 (from /cl/780780, /cl/780900)
+- `x/tools/go/analysis/vet: export cmd/vet and cmd/fix's []*Analyzer suites`
+- `go/analysis/suite/{fix,vet}: publish analyzer suites`
+- `cmd/{vet,fix}: use new constants from /x/tools/go/analysis/suite`
+
+### TODO: accepted proposal /issue/41184 (from /cl/773822)
+- `cmd/go: continue conversion to bug-resistant //go:build constraints`
+- `cmd/dist: use go/build/constraint to parse build constraints`
+
+### TODO: accepted proposal /issue/44143 (from /cl/752620)
+- `all: document uses of context.Background by APIs`
+- `log/slog: document context.Background use in non-Context methods`
+
+### TODO: accepted proposal /issue/50447 (from /cl/783322, /cl/783440)
+- `x/exp/typeparams: a new module with a transitional API for tools`
+- `typeparams: consider String methods optional`
+- `typeparams: simplify now that minimum required Go is 1.25.0`
+
+### TODO: accepted proposal /issue/50603 (from /cl/751920)
+- `` cmd/go: stamp the pseudo-version in builds generated by `go build` ``
+- `extension/src/language: update developer version detection logic`
+
+### TODO: accepted proposal /issue/60641 (from /cl/754400)
+- `runtime: enforce standard descriptors are open on initialization`
+- `runtime: std FDs are always opened, not only when AT_SECURE is set`
+
+### TODO: accepted proposal /issue/61515 (from /cl/744881)
+- `testing: add testing.B.Loop for iteration`
+- `log/slog: use B.Loop to simplify the code`
+
+### TODO: accepted proposal /issue/61902 (from /cl/742801)
+- `regexp: add iterator forms of matching methods`
+- `regexp: reimplement API using iterators, revise doc comments`
+
+### TODO: accepted proposal /issue/62047 (from /cl/743341)
+- `cmd: drop support for GOROOT_FINAL`
+- `internal/relui: leave out GOROOT_FINAL when building distpacks`
+
+### TODO: accepted proposal /issue/62121 (from /cl/753741)
+- `reflect: add TypeAssert`
+- `reflect: document corner cases of TypeAssert`
+
+### TODO: accepted proposal /issue/62728 (from /cl/601535, /cl/628615, /cl/751940)
+- `testing: annotate output text type`
+- `testing: annotate output text type`
+- `cmd/internal/test2json: generate and validate test artifacts`
+- `testing: escapes framing markers`
+
+### TODO: accepted proposal /issue/63131 (from /cl/746380)
+- `cmd/compile: create GOARCH=wasm32`
+- `cmd/compile: use HasPointers in memcombine to match write barrier check`
+
+### TODO: accepted proposal /issue/63696 (from /cl/747380)
+- `cmd/doc: support 'go doc package@version' syntax`
+- `cmd/go/internal/doc: support @version suffix on first argument`
+
+### TODO: accepted proposal /issue/63741 (from /cl/723102)
+- `doc/godebug: allow carve out for GODEBUGs introduced in security releases`
+- `doc: document GODEBUG carve out for security releases`
+
+### TODO: accepted proposal /issue/67001 (from /cl/746602)
+- `all: require Linux 3.2 kernel for Go 1.24`
+- `Linux: update requirements to kernel 3.2 or later`
+
+### TODO: accepted proposal /issue/67817 (from /cl/751640)
+- `x/net/http2: deprecate WriteScheduler`
+- `http2: deprecate write schedulers`
+
+### TODO: accepted proposal /issue/69985 (from /cl/777220)
+- `crypto/tls: add X25519MLKEM768 and use by default; remove x25519Kyber768Draft00`
+- `crypto/tls: let Config.CurvePreferences override GODEBUG options`
+
+### TODO: accepted proposal /issue/70872 (from /cl/755580)
+- `x/tools/cmd/auth: tag and delete`
+- `cmd/auth: tag and delete deprecated auth module`
+
+### TODO: accepted proposal /issue/71206 (from /cl/777220)
+- `crypto/tls: add support for NIST curve based ML-KEM hybrids`
+- `crypto/tls: let Config.CurvePreferences override GODEBUG options`
+
+### TODO: accepted proposal /issue/71497 (from /cl/773962, /cl/775180, /cl/779302)
+- `encoding/json/v2: new API for encoding/json`
+- `internal/buildcfg: enable JSONv2 as baseline`
+- `encoding/json: clarify that v1 Marshal calls MarshalerTo methods`
+- `encoding/json/internal/jsontest: rename testdata to _embed`
+
+### TODO: accepted proposal /issue/71867 (from /cl/756220)
+- `cmd/go, cmd/distpack: build and run tools that are not necessary for builds as needed and don't include in binary distribution`
+- `cmd/go: specify full path to go command when running go tool covdata`
+
+### TODO: accepted proposal /issue/73878 (from /cl/676455, /cl/754520, /cl/765402, /cl/766880, /cl/767100)
+- `x/tools/go/analysis: add GoMod, ... fields to Module`
+- `go/analysis: expose GoMod etc. to Pass.Module`
+- `go/analysis/checker: suppress TestPassModule on WASI`
+- `go/analysis/unitchecker: add Config.Module`
+- `all: update to x/tools@55fb96f`
+- `gopls/internal/cache: set Pass.Module`
+
+### TODO: accepted proposal /issue/74609 (from /cl/774620, /cl/774621, /cl/775621)
+- `runtime/pprof,runtime: new goroutine leak profile`
+- `internal/buildcfg: enable goroutineleakprofile GOEXPERIMENT by default`
+- `internal/goexperiment,runtime: drop goroutineleakprofile experiment`
+- `internal/goexperiment: actually delete goroutineleakprofile experiment`
+
+### TODO: accepted proposal /issue/75154 (from /cl/747160)
+- `crypto/sha3: make the zero value of SHA3 useable`
+- `crypto/sha3: ensure unwrapped *sha3.Digest are usable`
+
+### TODO: accepted proposal /issue/75316 (from /cl/777380, /cl/777381, /cl/777382, /cl/777383, /cl/777384)
+- `crypto: remove in Go 1.27 GODEBUGs introduced in Go 1.23 and earlier`
+- `crypto/tls: remove the tlsunsafeekm GODEBUG setting`
+- `crypto/tls: remove tlsrsakex GODEBUG setting`
+- `crypto/tls: remove tls3des GODEBUG setting`
+- `crypto/tls: remove the tls10server GODEBUG setting`
+- `crypto/tls: remove the x509keypairleaf GODEBUG setting`
+
+### TODO: accepted proposal /issue/76031 (from /cl/738701)
+- `go/ast: add BasicLit.ValueEnd field`
+- `go/parser: use (*Scanner).End instead of scannerhooks`
+
+### TODO: accepted proposal /issue/76146 (from /cl/717140)
+- `x/crypto/ssh: add AuthCallback to ClientConfig`
+- `ssh: add AuthCallback to ClientConfig`
+
+### TODO: accepted proposal /issue/76361 (from /cl/738821)
+- `x/tools/go/ast/inspector: add (*Cursor).Valid() bool method`
+- `go/ast/inspector: add Cursor.Valid method`
+
+### TODO: accepted proposal /issue/76477 (from /cl/728922)
+- `secret,crypto/subtle: make all "bubbles" inherited across goroutines`
+- `runtime/secret: implement goroutine inheriting secret state`
+
+### TODO: accepted proposal /issue/77006 (from /cl/738100)
+- `x/net/html: add NodeType.String() method`
+- `html: add NodeType.String() method`
+
+### TODO: accepted proposal /issue/77195 (from /cl/740280)
+- `x/tools/go/astutil/inspector: add Cursor.ParentEdge{Kind,Index} convenience accessors`
+- `go/ast/inspector: add Cursor.ParentEdge{Kind,Index} methods`
+
+### TODO: accepted proposal /issue/77653 (from /cl/749980)
+- `` cmd/go: change `go mod init` default go directive back to 1.N ``
+- `cmd/go: revert update default go directive in mod or work init`
+
+### TODO: accepted proposal /issue/77887 (from /cl/769300)
+- `doc: clarify if simple helper methods on x/sys syscall data structures require a proposal`
+- `README: clarify rules about golang.org/x/sys/windows contributions`
+
+### TODO: accepted proposal /issue/77986 (from /cl/774360)
+- `x/tools/go/analysis/passes/modernize: vars for atomic, embedlit, errorsastype, plusbuild, stringscut, stditerators`
+- `go/analysis/passes/modernize: publish modernizers`
+
+### TODO: accepted proposal /issue/79139 (from /cl/773040, /cl/774881)
+- `go/importer: documentation of lookup parameter of ForCompiler can be clarified`
+- `go/importer: un-deprecate importer.ForCompiler`
+- `cmd/api: fix false positive and false negative in isDeprecated`