all: make struct comments match struct names

Change-Id: I011f66854a9af5f3baa20abebd4b315c15db571f
Reviewed-on: https://go-review.googlesource.com/c/go/+/596715
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
TryBot-Result: Gopher Robot <gobot@golang.org>
Run-TryBot: shuang cui <imcusg@gmail.com>
Auto-Submit: Dmitri Shuralyov <dmitshur@golang.org>
Reviewed-by: Ian Lance Taylor <iant@google.com>
Auto-Submit: Ian Lance Taylor <iant@google.com>
Commit-Queue: Ian Lance Taylor <iant@google.com>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>

src/cmd/trace/gstate.go

@@ -46,7 +46,7 @@ type gState[R resource] struct {
 	// goroutine stopped executing. These are flushed on every stop or block.
 	completedRanges []completedRange
 
-	// startRunning is the most recent event that caused a goroutine to
+	// startRunningTime is the most recent event that caused a goroutine to
 	// transition to GoRunning.
 	startRunningTime trace.Time
 

src/internal/coverage/defs.go

@@ -267,7 +267,7 @@ func (cm CounterGranularity) String() string {
 // by the Go command and by the coverage runtime.
 const MetaFilesFileName = "metafiles.txt"
 
-// MetaFilePaths contains information generated by the Go command and
+// MetaFileCollection contains information generated by the Go command and
 // the read in by coverage test support functions within an executing
 // "go test -cover" binary.
 type MetaFileCollection struct {

src/log/slog/internal/buffer/buffer.go

@@ -7,7 +7,10 @@ package buffer
 
 import "sync"
 
-// buffer adapted from go/src/fmt/print.go
+// Buffer is a byte buffer.
+//
+// This implementation is adapted from the unexported type buffer
+// in go/src/fmt/print.go.
 type Buffer []byte
 
 // Having an initial size gives a dramatic speedup.

src/runtime/arena.go

@@ -232,7 +232,7 @@ func userArenaChunkReserveBytes() uintptr {
 }
 
 type userArena struct {
-	// full is a list of full chunks that have not enough free memory left, and
+	// fullList is a list of full chunks that have not enough free memory left, and
 	// that we'll free once this user arena is freed.
 	//
 	// Can't use mSpanList here because it's not-in-heap.

src/sync/export_test.go

@@ -10,7 +10,7 @@ var Runtime_Semrelease = runtime_Semrelease
 var Runtime_procPin = runtime_procPin
 var Runtime_procUnpin = runtime_procUnpin
 
-// poolDequeue testing.
+// PoolDequeue exports an interface for pollDequeue testing.
 type PoolDequeue interface {
 	PushHead(val any) bool
 	PopHead() (any, bool)