mirror of
https://github.com/golang/go
synced 2024-10-14 03:43:28 +00:00
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:
parent
fae6eb5f2f
commit
3f90ba7f1f
|
@ -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)
|
||||
|
|
|
@ -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:
|
||||
|
|
|
@ -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
|
||||
|
|
Loading…
Reference in a new issue