commit | 850992195362f2f0edc3aa1fe8554761efa83de4 | [log] [tgz] |
---|---|---|
author | Jonathan Amsterdam <jba@google.com> | Tue Nov 08 15:13:51 2022 -0500 |
committer | Jonathan Amsterdam <jba@google.com> | Mon Nov 14 19:14:08 2022 +0000 |
tree | c6b35952f38642acda4bcc08982519b2244dbc61 | |
parent | 0cf76af32a3a2a32486689c9652f5b82620616ad [diff] |
doc.go: package documentation: initial section and outline This CL has the opening paragraphs of the package documentation, and an outline of the rest. It is organized for users who will write log output using existing Handlers, since they are in the majority. Change-Id: I78766b643ae8f81595920ac4f9079a270369c596 Reviewed-on: https://go-review.googlesource.com/c/exp/+/448717 TryBot-Result: Gopher Robot <gobot@golang.org> Reviewed-by: Alan Donovan <adonovan@google.com> Run-TryBot: Jonathan Amsterdam <jba@google.com>
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.