cmd/link: `go doc cmd/link` and `go tool link -h` see different options

[linsite]

by roughly checking , go tool link -h at least has -randlayout, -capturehostobjs,-benchmark, -benchmarkprofile options which go doc cmd/link doesn't.

go version devel go1.25-fbfc9e09cb Thu Feb 27 08:22:57 2025 +0800 linux/arm64

is this intended or should be consistent?

[ianlancetaylor]

It should be kept consistent.

[obeyda]

Hi,
I would like to fix this issue. After reviewing both commands output the following flags are present in go tool link -h but were missing in go doc cmd/link:

• -a
• -benchmark
• -benchmarkprofile
• -capturehostobjs
• -debugnosplit
• -debugtextsize
• -debugtramp
• -fipso
• -h
• -n
• -pruneweakmap
• -randlayout
• -strictdups

I think fixing this should be as simple as taking the output from go tool link -h and updating the src/cmd/link/doc.go file directly.
I'll push a CL soon with these changes and would appreciate feedback.

[linsite]

Hi, I would like to fix this issue. After reviewing both commands output the following flags are present in go tool link -h but were missing in go doc cmd/link:

• -a
• -benchmark
• -benchmarkprofile
• -capturehostobjs
• -debugnosplit
• -debugtextsize
• -debugtramp
• -fipso
• -h
• -n
• -pruneweakmap
• -randlayout
• -strictdups

I think fixing this should be as simple as taking the output from go tool link -h and updating the src/cmd/link/doc.go file directly. I'll push a CL soon with these changes and would appreciate feedback.

Thanks, feel free to go for it.

[gopherbot]

Change https://go.dev/cl/661235 mentions this issue: cmd/link: update doc.go to include all flags present in -h output