From 3f90ba7f1f0ecb230105ad1068ffdc3c2f9a8a97 Mon Sep 17 00:00:00 2001 From: Olivier Mengué Date: Wed, 27 Mar 2024 23:09:23 +0100 Subject: go/ast: more godoc links Change-Id: I1290ad66d3c758c3b89caf0a217cb3d5358c5dd2 Reviewed-on: https://go-review.googlesource.com/c/go/+/574696 Reviewed-by: Robert Griesemer Auto-Submit: Ian Lance Taylor LUCI-TryBot-Result: Go LUCI Reviewed-by: Ian Lance Taylor --- src/go/ast/ast.go | 9 ++++++--- src/go/ast/print.go | 4 ++-- src/go/ast/scope.go | 4 ++-- 3 files changed, 10 insertions(+), 7 deletions(-) diff --git a/src/go/ast/ast.go b/src/go/ast/ast.go index ef96cc4a6df..73aa3da89ea 100644 --- a/src/go/ast/ast.go +++ b/src/go/ast/ast.go @@ -1032,9 +1032,12 @@ func (*FuncDecl) declNode() {} // positions). A [CommentMap] may be used to facilitate some of these operations. // // Whether and how a comment is associated with a node depends on the -// interpretation of the syntax tree by the manipulating program: Except for Doc +// interpretation of the syntax tree by the manipulating program: except for Doc // and [Comment] comments directly associated with nodes, the remaining comments -// are "free-floating" (see also issues #18593, #20744). +// are "free-floating" (see also issues [#18593], [#20744]). +// +// [#18593]: https://go.dev/issue/18593 +// [#20744]: https://go.dev/issue/20744 type File struct { Doc *CommentGroup // associated documentation; or nil Package token.Pos // position of "package" keyword @@ -1080,7 +1083,7 @@ func (p *Package) End() token.Pos { return token.NoPos } // not handwritten, by detecting the special comment described // at https://go.dev/s/generatedcode. // -// The syntax tree must have been parsed with the ParseComments flag. +// The syntax tree must have been parsed with the [parser.ParseComments] flag. // Example: // // f, err := parser.ParseFile(fset, filename, src, parser.ParseComments|parser.PackageClauseOnly) diff --git a/src/go/ast/print.go b/src/go/ast/print.go index d1aad50103a..ccef0577da0 100644 --- a/src/go/ast/print.go +++ b/src/go/ast/print.go @@ -17,8 +17,8 @@ import ( // A FieldFilter may be provided to [Fprint] to control the output. type FieldFilter func(name string, value reflect.Value) bool -// NotNilFilter returns true for field values that are not nil; -// it returns false otherwise. +// NotNilFilter is a [FieldFilter] that returns true for field values +// that are not nil; it returns false otherwise. func NotNilFilter(_ string, v reflect.Value) bool { switch v.Kind() { case reflect.Chan, reflect.Func, reflect.Interface, reflect.Map, reflect.Pointer, reflect.Slice: diff --git a/src/go/ast/scope.go b/src/go/ast/scope.go index 039ca58bc09..9d97e24e298 100644 --- a/src/go/ast/scope.go +++ b/src/go/ast/scope.go @@ -144,10 +144,10 @@ func (obj *Object) Pos() token.Pos { return token.NoPos } -// ObjKind describes what an object represents. +// ObjKind describes what an [Object] represents. type ObjKind int -// The list of possible Object kinds. +// The list of possible [Object] kinds. const ( Bad ObjKind = iota // for error handling Pkg // package -- cgit v1.2.3-54-g00ecf