dox4/go
1
0
Fork 0
mirror of https://github.com/golang/go.git synced 2026-08-02 05:25:23 +08:00
Code Issues Packages Projects Releases Wiki Activity

doc: inserted TODOs into 9-todo.md

Browse Source 
Two known unnecessary/done ones have been removed, the
rest are as is.

Change-Id: I859efee292e06cd4877a814280950a47fac5bf43
Reviewed-on: https://go-review.googlesource.com/c/go/+/784480
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
LUCI-TryBot-Result: golang-scoped@luci-project-accounts.iam.gserviceaccount.com <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
This commit is contained in:
David Chase 2026-05-28 14:26:28 -04:00
parent 3ef3b74c86
commit 6449874f49
1 changed files with 183 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

183
doc/next/9-todo.md Normal file
View File

@ -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`