diff --git a/src/cmd/compile/internal/ir/expr.go b/src/cmd/compile/internal/ir/expr.go index e228719737..7a75ff40f2 100644 --- a/src/cmd/compile/internal/ir/expr.go +++ b/src/cmd/compile/internal/ir/expr.go @@ -617,7 +617,7 @@ func (o Op) IsSlice3() bool { return false } -// A SliceHeader expression constructs a slice header from its parts. +// A SliceHeaderExpr constructs a slice header from its parts. type SliceHeaderExpr struct { miniExpr Ptr Node diff --git a/src/cmd/compile/internal/types/type.go b/src/cmd/compile/internal/types/type.go index 6a3e9b512e..da859290f7 100644 --- a/src/cmd/compile/internal/types/type.go +++ b/src/cmd/compile/internal/types/type.go @@ -328,7 +328,7 @@ func (t *Type) funcType() *Func { return t.extra.(*Func) } -// StructType contains Type fields specific to struct types. +// Struct contains Type fields specific to struct types. type Struct struct { fields fields diff --git a/src/cmd/compile/internal/types2/object.go b/src/cmd/compile/internal/types2/object.go index 7096c55697..0c785efa82 100644 --- a/src/cmd/compile/internal/types2/object.go +++ b/src/cmd/compile/internal/types2/object.go @@ -327,7 +327,7 @@ func (obj *TypeName) IsAlias() bool { } } -// A Variable represents a declared variable (including function parameters and results, and struct fields). +// A Var represents a declared variable (including function parameters and results, and struct fields). type Var struct { object origin *Var // if non-nil, the Var from which this one was instantiated diff --git a/src/cmd/go/internal/vet/vet.go b/src/cmd/go/internal/vet/vet.go index a2625b2118..247e139b4f 100644 --- a/src/cmd/go/internal/vet/vet.go +++ b/src/cmd/go/internal/vet/vet.go @@ -396,7 +396,7 @@ type jsonError struct { Err string `json:"error"` } -// A TextEdit describes the replacement of a portion of a file. +// A jsonTextEdit describes the replacement of a portion of a file. // Start and End are zero-based half-open indices into the original byte // sequence of the file, and New is the new text. type jsonTextEdit struct { @@ -424,7 +424,7 @@ type jsonDiagnostic struct { Related []jsonRelatedInformation `json:"related,omitempty"` } -// A jsonRelated describes a secondary position and message related to +// A jsonRelatedInformation describes a secondary position and message related to // a primary diagnostic. type jsonRelatedInformation struct { Posn string `json:"posn"` // e.g. "file.go:line:column" diff --git a/src/cmd/internal/obj/x86/evex.go b/src/cmd/internal/obj/x86/evex.go index aa93cd8819..12fe034704 100644 --- a/src/cmd/internal/obj/x86/evex.go +++ b/src/cmd/internal/obj/x86/evex.go @@ -165,7 +165,7 @@ func evexZcase(zcase uint8) bool { return zcase > Zevex_first && zcase < Zevex_last } -// evexSuffixBits carries instruction EVEX suffix set flags. +// evexSuffix carries instruction EVEX suffix set flags. // // Examples: // diff --git a/src/cmd/internal/objfile/goobj.go b/src/cmd/internal/objfile/goobj.go index e8b8b52251..c428e29c9b 100644 --- a/src/cmd/internal/objfile/goobj.go +++ b/src/cmd/internal/objfile/goobj.go @@ -227,7 +227,7 @@ func (f *goobjFile) pcln() (textStart uint64, symtab, pclntab []byte, err error) return 0, nil, nil, fmt.Errorf("pcln not available in go object file") } -// Find returns the file name, line, and function data for the given pc. +// PCToLine returns the file name, line, and function data for the given pc. // Returns "",0,nil if unknown. // This function implements the Liner interface in preference to pcln() above. func (f *goobjFile) PCToLine(pc uint64) (string, int, *gosym.Func) { diff --git a/src/cmd/link/internal/loader/symbolbuilder.go b/src/cmd/link/internal/loader/symbolbuilder.go index 35749f9ea9..d385dec94a 100644 --- a/src/cmd/link/internal/loader/symbolbuilder.go +++ b/src/cmd/link/internal/loader/symbolbuilder.go @@ -139,7 +139,7 @@ func (sb *SymbolBuilder) SetRelocAdd(i int, a int64) { sb.relocs[i].SetAdd(a) } -// SetRelocAdd sets the size of the 'i'-th relocation on this sym to 'sz' +// SetRelocSiz sets the size of the 'i'-th relocation on this sym to 'sz' func (sb *SymbolBuilder) SetRelocSiz(i int, sz uint8) { sb.relocs[i].SetSiz(sz) } diff --git a/src/crypto/internal/fips140/rsa/pkcs1v22.go b/src/crypto/internal/fips140/rsa/pkcs1v22.go index de7943773e..94e7345996 100644 --- a/src/crypto/internal/fips140/rsa/pkcs1v22.go +++ b/src/crypto/internal/fips140/rsa/pkcs1v22.go @@ -316,7 +316,7 @@ func VerifyPSS(pub *PublicKey, hash hash.Hash, digest []byte, sig []byte) error return verifyPSS(pub, hash, digest, sig, pssSaltLengthAutodetect) } -// VerifyPSS verifies sig with RSASSA-PSS and an expected salt length. +// VerifyPSSWithSaltLength verifies sig with RSASSA-PSS and an expected salt length. func VerifyPSSWithSaltLength(pub *PublicKey, hash hash.Hash, digest []byte, sig []byte, saltLength int) error { if saltLength < 0 { return errors.New("crypto/rsa: salt length cannot be negative") diff --git a/src/crypto/x509/oid.go b/src/crypto/x509/oid.go index b1464346b6..c60daa7540 100644 --- a/src/crypto/x509/oid.go +++ b/src/crypto/x509/oid.go @@ -286,7 +286,7 @@ func (oid OID) EqualASN1OID(other asn1.ObjectIdentifier) bool { return i == len(other) } -// Strings returns the string representation of the Object Identifier. +// String returns the string representation of the Object Identifier. func (oid OID) String() string { var b strings.Builder b.Grow(32) diff --git a/src/debug/dwarf/entry.go b/src/debug/dwarf/entry.go index 8741479483..30fad93e79 100644 --- a/src/debug/dwarf/entry.go +++ b/src/debug/dwarf/entry.go @@ -229,7 +229,7 @@ func formToClass(form format, attr Attr, vers int, b *buf) Class { } } -// An entry is a sequence of attribute/value pairs. +// An Entry is a sequence of attribute/value pairs. type Entry struct { Offset Offset // offset of Entry in DWARF info Tag Tag // tag (kind of Entry) diff --git a/src/go/scanner/scanner.go b/src/go/scanner/scanner.go index 153252b5cc..cdbeb6323c 100644 --- a/src/go/scanner/scanner.go +++ b/src/go/scanner/scanner.go @@ -107,7 +107,7 @@ func (s *Scanner) peek() byte { return 0 } -// A mode value is a set of flags (or 0). +// A Mode value is a set of flags (or 0). // They control scanner behavior. type Mode uint diff --git a/src/go/types/object.go b/src/go/types/object.go index 823c03c7fd..3b15bfbb61 100644 --- a/src/go/types/object.go +++ b/src/go/types/object.go @@ -330,7 +330,7 @@ func (obj *TypeName) IsAlias() bool { } } -// A Variable represents a declared variable (including function parameters and results, and struct fields). +// A Var represents a declared variable (including function parameters and results, and struct fields). type Var struct { object origin *Var // if non-nil, the Var from which this one was instantiated diff --git a/src/internal/coverage/cmerge/merge.go b/src/internal/coverage/cmerge/merge.go index 1339803d08..9fc548eced 100644 --- a/src/internal/coverage/cmerge/merge.go +++ b/src/internal/coverage/cmerge/merge.go @@ -57,7 +57,7 @@ func (m *Merger) MergeCounters(dst, src []uint32) (error, bool) { return nil, ovf } -// Saturating add does a saturating addition of 'dst' and 'src', +// SaturatingAdd does a saturating addition of 'dst' and 'src', // returning added value or math.MaxUint32 if there is an overflow. // Overflows are recorded in case the client needs to track them. func (m *Merger) SaturatingAdd(dst, src uint32) uint32 { @@ -68,7 +68,7 @@ func (m *Merger) SaturatingAdd(dst, src uint32) uint32 { return result } -// Saturating add does a saturating addition of 'dst' and 'src', +// SaturatingAdd does a saturating addition of 'dst' and 'src', // returning added value or math.MaxUint32 plus an overflow flag. func SaturatingAdd(dst, src uint32) (uint32, bool) { d, s := uint64(dst), uint64(src) diff --git a/src/internal/goarch/goarch.go b/src/internal/goarch/goarch.go index 4da56dda9d..efcf298d3b 100644 --- a/src/internal/goarch/goarch.go +++ b/src/internal/goarch/goarch.go @@ -34,7 +34,7 @@ const ( // It is also the size of the machine's native word size (that is, 4 on 32-bit systems, 8 on 64-bit). const PtrSize = 4 << (^uintptr(0) >> 63) -// PtrSize is bit width of a pointer. +// PtrBits is bit width of a pointer. const PtrBits = PtrSize * 8 // ArchFamily is the architecture family (AMD64, ARM, ...) diff --git a/src/internal/trace/event.go b/src/internal/trace/event.go index 321e4e21fb..b78e523294 100644 --- a/src/internal/trace/event.go +++ b/src/internal/trace/event.go @@ -197,7 +197,7 @@ type Range struct { Scope ResourceID } -// RangeAttributes provides attributes about a completed Range. +// RangeAttribute provides attributes about a completed Range. type RangeAttribute struct { // Name is the human-readable name for the range. Name string diff --git a/src/text/template/parse/parse.go b/src/text/template/parse/parse.go index 84d639d78d..b74dfb7f4e 100644 --- a/src/text/template/parse/parse.go +++ b/src/text/template/parse/parse.go @@ -35,7 +35,7 @@ type Tree struct { stackDepth int // depth of nested parenthesized expressions } -// A mode value is a set of flags (or 0). Modes control parser behavior. +// A Mode value is a set of flags (or 0). Modes control parser behavior. type Mode uint const (