all: make function and struct comments match the names

Change-Id: Ia7d5c0bb0299d9d898e62740c3e05fc1e5cbf9cd
Reviewed-on: https://go-review.googlesource.com/c/tools/+/639477
LUCI-TryBot-Result: Go LUCI <[email protected]>
Reviewed-by: Michael Matloob <[email protected]>
Reviewed-by: Ian Lance Taylor <[email protected]>
Auto-Submit: Ian Lance Taylor <[email protected]>

Author: cuishuang

cmd/bisect/main.go

@@ -262,7 +262,7 @@ type Bisect struct {
 	// each pattern starts with a !.
 	Disable bool
 
-	// SkipDigits is the number of hex digits to use in skip messages.
+	// SkipHexDigits is the number of hex digits to use in skip messages.
 	// If the set of available changes is the same in each run, as it should be,
 	// then this doesn't matter: we'll only exclude suffixes that uniquely identify
 	// a given change. But for some programs, especially bisecting runtime

go/packages/packages_test.go

@@ -3222,7 +3222,7 @@ func TestIssue70394(t *testing.T) {
 	}
 }
 
-// TestNeedTypesInfoOnly tests when NeedTypesInfo was set and NeedSyntax & NeedTypes were not,
+// TestLoadTypesInfoWithoutSyntaxOrTypes tests when NeedTypesInfo was set and NeedSyntax & NeedTypes were not,
 // Load should include the TypesInfo of packages properly
 func TestLoadTypesInfoWithoutSyntaxOrTypes(t *testing.T) {
 	testAllOrModulesParallel(t, testLoadTypesInfoWithoutSyntaxOrTypes)

gopls/internal/cache/typerefs/pkggraph_test.go

@@ -40,7 +40,7 @@ type Package struct {
 	// transitively reachable through references, starting with the given decl.
 	transitiveRefs map[string]*typerefs.PackageSet
 
-	// ReachesViaDeps records the set of packages in the containing graph whose
+	// ReachesByDeps records the set of packages in the containing graph whose
 	// syntax may affect the current package's types. See the package
 	// documentation for more details of what this means.
 	ReachesByDeps *typerefs.PackageSet

gopls/internal/golang/codeaction.go

@@ -172,7 +172,7 @@ func (req *codeActionsRequest) addCommandAction(cmd *protocol.Command, allowReso
 	req.addAction(act)
 }
 
-// addCommandAction adds an edit-based CodeAction to the result.
+// addEditAction adds an edit-based CodeAction to the result.
 func (req *codeActionsRequest) addEditAction(title string, fixedDiagnostics []protocol.Diagnostic, changes ...protocol.DocumentChange) {
 	req.addAction(protocol.CodeAction{
 		Title:       title,
@@ -648,7 +648,7 @@ func refactorRewriteChangeQuote(ctx context.Context, req *codeActionsRequest) er
 	return nil
 }
 
-// refactorRewriteChangeQuote produces "Invert 'if' condition" code actions.
+// refactorRewriteInvertIf produces "Invert 'if' condition" code actions.
 // See [invertIfCondition] for command implementation.
 func refactorRewriteInvertIf(ctx context.Context, req *codeActionsRequest) error {
 	if _, ok, _ := canInvertIfCondition(req.pgf.File, req.start, req.end); ok {

gopls/internal/golang/completion/postfix_snippets.go

@@ -69,7 +69,7 @@ type postfixTmplArgs struct {
 	// Type is the type of "foo.bar" in "foo.bar.print!".
 	Type types.Type
 
-	// FuncResult are results of the enclosed function
+	// FuncResults are results of the enclosed function
 	FuncResults []*types.Var
 
 	sel            *ast.SelectorExpr

gopls/internal/golang/extract.go

@@ -1654,7 +1654,7 @@ var conventionalVarNames = map[objKey]string{
 	{"http", "ResponseWriter"}: "rw", // Note: same as [AbbreviateVarName].
 }
 
-// varNameForTypeName chooses a "good" name for a variable with the given type,
+// varNameForType chooses a "good" name for a variable with the given type,
 // if possible. Otherwise, it returns "", false.
 //
 // For special types, it uses known conventional names.

gopls/internal/protocol/command/interface.go

@@ -525,7 +525,7 @@ type RunVulncheckResult struct {
 	Token protocol.ProgressToken
 }
 
-// GovulncheckResult holds the result of synchronously running the vulncheck
+// VulncheckResult holds the result of synchronously running the vulncheck
 // command.
 type VulncheckResult struct {
 	// Result holds the result of running vulncheck.
@@ -695,7 +695,7 @@ type PackagesResult struct {
 	// Packages is an unordered list of package metadata.
 	Packages []Package
 
-	// Modules maps module path to module metadata for
+	// Module maps module path to module metadata for
 	// all the modules of the returned Packages.
 	Module map[string]Module
 }

gopls/internal/protocol/generate/types.go

@@ -112,7 +112,7 @@ type Type struct {
 	Line    int     `json:"line"`    // JSON source line
 }
 
-// ParsedLiteral is Type.Value when Type.Kind is "literal"
+// ParseLiteral is Type.Value when Type.Kind is "literal"
 type ParseLiteral struct {
 	Properties `json:"properties"`
 }

gopls/internal/server/general.go

@@ -610,7 +610,7 @@ func (s *server) fileOf(ctx context.Context, uri protocol.DocumentURI) (file.Han
 	return fh, snapshot, release, nil
 }
 
-// shutdown implements the 'shutdown' LSP handler. It releases resources
+// Shutdown implements the 'shutdown' LSP handler. It releases resources
 // associated with the server and waits for all ongoing work to complete.
 func (s *server) Shutdown(ctx context.Context) error {
 	ctx, done := event.Start(ctx, "lsp.Server.shutdown")

gopls/internal/server/selection_range.go

@@ -15,7 +15,7 @@ import (
 	"golang.org/x/tools/internal/event"
 )
 
-// selectionRange defines the textDocument/selectionRange feature,
+// SelectionRange defines the textDocument/selectionRange feature,
 // which, given a list of positions within a file,
 // reports a linked list of enclosing syntactic blocks, innermost first.
 //