From: cui fliter Date: Fri, 13 Oct 2023 06:59:10 +0000 (+0800) Subject: errors: add available godoc link X-Git-Tag: go1.22rc1~442 X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=925a4d93dcc958ee9250bcc213baa0fc7bd892ae;p=gostls13.git errors: add available godoc link Change-Id: Ie86493ebad3c3d7ea914754451985d7ee3e8e270 Reviewed-on: https://go-review.googlesource.com/c/go/+/535080 Reviewed-by: Ian Lance Taylor Run-TryBot: shuang cui TryBot-Result: Gopher Robot Reviewed-by: Cherry Mui Reviewed-by: qiulaidongfeng <2645477756@qq.com> --- diff --git a/src/errors/errors.go b/src/errors/errors.go index 41397774d3..9e3860aaa9 100644 --- a/src/errors/errors.go +++ b/src/errors/errors.go @@ -26,7 +26,7 @@ // itself followed by the tree of each of its children in turn // (pre-order, depth-first traversal). // -// Is examines the tree of its first argument looking for an error that +// [Is] examines the tree of its first argument looking for an error that // matches the second. It reports whether it finds a match. It should be // used in preference to simple equality checks: // @@ -38,7 +38,7 @@ // // because the former will succeed if err wraps [io/fs.ErrExist]. // -// As examines the tree of its first argument looking for an error that can be +// [As] examines the tree of its first argument looking for an error that can be // assigned to its second argument, which must be a pointer. If it succeeds, it // performs the assignment and returns true. Otherwise, it returns false. The form // @@ -80,7 +80,7 @@ func (e *errorString) Error() string { // // errors.Is(err, errors.ErrUnsupported) // -// either by directly wrapping ErrUnsupported or by implementing an Is method. +// either by directly wrapping ErrUnsupported or by implementing an [Is] method. // // Functions and methods should document the cases in which an error // wrapping this will be returned. diff --git a/src/errors/wrap.go b/src/errors/wrap.go index 756de6cc1c..e1cc466eea 100644 --- a/src/errors/wrap.go +++ b/src/errors/wrap.go @@ -27,7 +27,7 @@ func Unwrap(err error) error { // Is reports whether any error in err's tree matches target. // // The tree consists of err itself, followed by the errors obtained by repeatedly -// calling Unwrap. When err wraps multiple errors, Is examines err followed by a +// calling [Unwrap]. When err wraps multiple errors, Is examines err followed by a // depth-first traversal of its children. // // An error is considered to match a target if it is equal to that target or if @@ -40,7 +40,7 @@ func Unwrap(err error) error { // // then Is(MyError{}, fs.ErrExist) returns true. See [syscall.Errno.Is] for // an example in the standard library. An Is method should only shallowly -// compare err and the target and not call Unwrap on either. +// compare err and the target and not call [Unwrap] on either. func Is(err, target error) bool { if target == nil { return err == target @@ -81,7 +81,7 @@ func is(err, target error, targetComparable bool) bool { // target to that error value and returns true. Otherwise, it returns false. // // The tree consists of err itself, followed by the errors obtained by repeatedly -// calling Unwrap. When err wraps multiple errors, As examines err followed by a +// calling [Unwrap]. When err wraps multiple errors, As examines err followed by a // depth-first traversal of its children. // // An error matches target if the error's concrete value is assignable to the value