all: fix some comments

Change-Id: I2fc378bec5e2d065fd4c9d27f36ab5b47748ffd0
Reviewed-on: https://go-review.googlesource.com/c/exp/+/464237
Reviewed-by: Ian Lance Taylor <[email protected]>
TryBot-Result: Gopher Robot <[email protected]>
Reviewed-by: Michael Knyszek <[email protected]>
Run-TryBot: Ian Lance Taylor <[email protected]>
Auto-Submit: Ian Lance Taylor <[email protected]>

Author: cuishuang

cmd/gorelease/gorelease.go

@@ -1470,7 +1470,7 @@ func loadRetractions(ctx context.Context, modRoot string) ([]string, error) {
 	return retracted, nil
 }
 
-// ShortRetractionRationale returns a retraction rationale string that is safe
+// shortRetractionRationale returns a retraction rationale string that is safe
 // to print in a terminal. It returns hard-coded strings if the rationale
 // is empty, too long, or contains non-printable characters.
 //

ebnf/parser.go

@@ -72,7 +72,7 @@ func (p *parser) parseToken() *Token {
 	return &Token{pos, value}
 }
 
-// ParseTerm returns nil if no term was found.
+// parseTerm returns nil if no term was found.
 func (p *parser) parseTerm() (x Expression) {
 	pos := p.pos
 

errors/fmt/scan.go

@@ -779,7 +779,7 @@ func (s *ss) convertFloat(str string, n int) float64 {
 	return f
 }
 
-// convertComplex converts the next token to a complex128 value.
+// scanComplex converts the next token to a complex128 value.
 // The atof argument is a type-specific reader for the underlying type.
 // If we're reading complex64, atof will parse float32s and convert them
 // to float64's to avoid reproducing this code for each complex type.

slog/handler.go

@@ -195,7 +195,7 @@ func (h *commonHandler) clone() *commonHandler {
 	}
 }
 
-// Enabled reports whether l is greater than or equal to the
+// enabled reports whether l is greater than or equal to the
 // minimum level.
 func (h *commonHandler) enabled(l Level) bool {
 	minLevel := LevelInfo

slog/json_handler.go

@@ -48,7 +48,7 @@ func (h *JSONHandler) Enabled(_ context.Context, level Level) bool {
 	return h.commonHandler.enabled(level)
 }
 
-// With returns a new JSONHandler whose attributes consists
+// WithAttrs returns a new JSONHandler whose attributes consists
 // of h's attributes followed by attrs.
 func (h *JSONHandler) WithAttrs(attrs []Attr) Handler {
 	return &JSONHandler{commonHandler: h.commonHandler.withAttrs(attrs)}

slog/text_handler.go

@@ -44,7 +44,7 @@ func (h *TextHandler) Enabled(_ context.Context, level Level) bool {
 	return h.commonHandler.enabled(level)
 }
 
-// With returns a new TextHandler whose attributes consists
+// WithAttrs returns a new TextHandler whose attributes consists
 // of h's attributes followed by attrs.
 func (h *TextHandler) WithAttrs(attrs []Attr) Handler {
 	return &TextHandler{commonHandler: h.commonHandler.withAttrs(attrs)}

slog/value_safe.go

@@ -48,7 +48,7 @@ func (v Value) str() string {
 	return v.s
 }
 
-// String returns a new Value for a string.
+// StringValue returns a new Value for a string.
 func StringValue(value string) Value {
 	return Value{s: value, any: KindString}
 }

slog/value_unsafe.go

@@ -57,7 +57,7 @@ func (v Value) Kind() Kind {
 	}
 }
 
-// String returns a new Value for a string.
+// StringValue returns a new Value for a string.
 func StringValue(value string) Value {
 	hdr := (*reflect.StringHeader)(unsafe.Pointer(&value))
 	return Value{num: uint64(hdr.Len), any: stringptr(hdr.Data)}
@@ -92,7 +92,7 @@ func groupValue(as []Attr) Value {
 	return Value{num: uint64(hdr.Len), any: groupptr(hdr.Data)}
 }
 
-// Group returns the Value's value as a []Attr.
+// group returns the Value's value as a []Attr.
 // It panics if the Value's Kind is not KindGroup.
 func (v Value) group() []Attr {
 	if sp, ok := v.any.(groupptr); ok {