mirror of
https://github.com/golang/go
synced 2024-11-02 11:50:30 +00:00
600225f83f
For #64169. Change-Id: I0fc6d6a041ad48957f4aecd18b85c9098fc9b403 Reviewed-on: https://go-review.googlesource.com/c/go/+/559755 LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com> Reviewed-by: Dmitri Shuralyov <dmitshur@google.com> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
26 lines
1.2 KiB
Text
26 lines
1.2 KiB
Text
Files in this directory are data for Go's API checker ("go tool api", in src/cmd/api).
|
|
|
|
Each file is a list of API features, one per line.
|
|
|
|
go1.txt (and similarly named files) are frozen once a version has been
|
|
shipped. Each file adds new lines but does not remove any.
|
|
|
|
except.txt lists features that may disappear without breaking true
|
|
compatibility.
|
|
|
|
Starting with go1.19.txt, each API feature line must end in "#nnnnn"
|
|
giving the GitHub issue number of the proposal issue that accepted
|
|
the new API. This helps with our end-of-cycle audit of new APIs.
|
|
The same requirement applies to next/* (described below), which will
|
|
become a go1.XX.txt for XX >= 19.
|
|
|
|
The next/ directory contains the only files intended to be mutated.
|
|
Each file in that directory contains a list of features that may be added
|
|
to the next release of Go. The files in this directory only affect the
|
|
warning output from the go api tool. Each file should be named
|
|
nnnnn.txt, after the issue number for the accepted proposal.
|
|
(The #nnnnn suffix must also appear at the end of each line in the file;
|
|
that will be preserved when next/*.txt is concatenated into go1.XX.txt.)
|
|
|
|
When you add a file to the api/next directory, you must add at least one file
|
|
under doc/next. See doc/README.md for details.
|