go/ast: more godoc links

Change-Id: I1290ad66d3c758c3b89caf0a217cb3d5358c5dd2
Reviewed-on: https://go-review.googlesource.com/c/go/+/574696
Reviewed-by: Robert Griesemer <gri@google.com>
Auto-Submit: Ian Lance Taylor <iant@google.com>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Reviewed-by: Ian Lance Taylor <iant@google.com>
This commit is contained in:
Olivier Mengué 2024-03-27 23:09:23 +01:00 committed by Gopher Robot
parent fae6eb5f2f
commit 3f90ba7f1f
3 changed files with 10 additions and 7 deletions

View file

@ -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)

View file

@ -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:

View file

@ -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