| // Copyright 2019 The Go Authors. All rights reserved. |
| // Use of this source code is governed by a BSD-style |
| // license that can be found in the LICENSE file. |
| |
| // Package xerrors implements functions to manipulate errors. |
| // |
| // This package supports transitioning to the Go 2 proposal for error values: |
| // https://golang.org/design/29934-error-values |
| // |
| // This is an EXPERIMENTAL package, and may change in arbitrary ways without notice. |
| // |
| // Most of the functions and types in this package will be incorporated into the |
| // standard library's errors package in Go 1.13; the behavior of this package's |
| // Errorf function will be incorporated into the standard library's fmt.Errorf. Use |
| // this package to get equivalent behavior in all supported Go versions. For example, |
| // create errors using |
| // |
| // xerrors.New("write failed") |
| // |
| // or |
| // |
| // xerrors.Errorf("while reading: %v", err) |
| // |
| // If you want your error type to participate in the new formatting implementation |
| // for %v and %+v, provide it with a Format method that calls xerrors.FormatError, as |
| // shown in the example for FormatError. |
| package xerrors // TODO import "golang.org/x/xerrors" |
