xerrors: add and modify documentation

Also split examples into separate files so their full contents appear
in the godoc.

Change-Id: I1c6432687262a59f9b0890d60d23de2e6022b08e
Reviewed-on: https://go-review.googlesource.com/c/159657
Reviewed-by: Marcel van Lohuizen <mpvl@golang.org>
Reviewed-by: Damien Neil <dneil@google.com>
9 files changed
tree: 1b56aacd54facbc718ab861b5cfcdecce63449d2
  1. apidiff/
  2. cmd/
  3. ebnf/
  4. ebnflint/
  5. errors/
  6. fsnotify/
  7. inotify/
  8. io/
  9. mmap/
  10. old/
  11. rand/
  12. shiny/
  13. shootout/
  14. utf8string/
  15. winfsnotify/
  16. xerrors/
  17. .gitattributes
  18. .gitignore
  19. AUTHORS
  20. codereview.cfg
  21. CONTRIBUTING.md
  22. CONTRIBUTORS
  23. LICENSE
  24. PATENTS
  25. README.md
README.md

exp

This subrepository holds experimental and deprecated (in the old directory) packages.

The idea for this subrepository originated as the pkg/exp directory of the main repository, but its presence there made it unavailable to users of the binary downloads of the Go installation. The subrepository has therefore been created to make it possible to go get these packages.

Warning: Packages here are experimental and unreliable. Some may one day be promoted to the main repository or other subrepository, or they may be modified arbitrarily or even disappear altogether.

In short, code in this subrepository is not subject to the Go 1 compatibility promise. (No subrepo is, but the promise is even more likely to be violated by go.exp than the others.)

Caveat emptor.