<!--
NOTE: In this document and others in this directory, the convention is to
set fixed-width phrases with non-fixed-width spaces, as in
`hello` `world`.
-->

<style>
  main ul li { margin: 0.5em 0; }
</style>

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"

The recommended way to file an issue is by running `go bug`.
Otherwise, when filing an issue, make sure to answer these five questions:

1. What version of Go are you using (`go version`)?
2. What operating system and processor architecture are you using?
3. What did you do?
4. What did you expect to see?
5. What did you see instead?

For change proposals, see [Proposing Changes To Go](https://go.dev/s/proposal-process).

pkg go/printer, type Config struct, Indent int
pkg go/scanner, const ScanComments = 1
pkg go/token, const ADD = 12
pkg go/token, const ADD_ASSIGN = 23
pkg go/token, const AND = 17
pkg go/token, const AND_ASSIGN = 28
pkg go/token, const AND_NOT = 22
pkg go/token, const AND_NOT_ASSIGN = 33
pkg go/token, const ARROW = 36
pkg go/token, const ASSIGN = 42
pkg go/token, const BREAK = 61
pkg go/token, const CASE = 62

pkg syscall (freebsd-riscv64), const BPF_ALU = 4 #53466
pkg syscall (freebsd-riscv64), const BPF_ALU ideal-int #53466
pkg syscall (freebsd-riscv64), const BPF_AND = 80 #53466
pkg syscall (freebsd-riscv64), const BPF_AND ideal-int #53466
pkg syscall (freebsd-riscv64), const BPF_B = 16 #53466
pkg syscall (freebsd-riscv64), const BPF_B ideal-int #53466
pkg syscall (freebsd-riscv64), const BPF_BUFMODE_BUFFER = 1 #53466

# of git and editors capable of LF line endings.
#
# Windows .bat files are known to have multiple bugs when run with LF
# endings, and so they are checked in with CRLF endings, with a test
# in test/winbatch.go to catch problems. (See golang.org/issue/37791.)
#
# We'll prevent accidental CRLF line endings from entering the repo
# via the git-codereview gofmt checks and tests.
#
# See golang.org/issue/9281.

The new [ParseCookie] function parses a Cookie header value and
returns all the cookies which were set in it. Since the same cookie
name can appear multiple times the returned Values can contain
more than one value for a given key.

The new [ParseSetCookie] function parses a Set-Cookie header value and

# Security Policy

## Supported Versions

We support the past two Go releases (for example, Go 1.17.x and Go 1.18.x when Go 1.18.x is the latest stable release).

See https://go.dev/wiki/Go-Release-Cycle and in particular the
[Release Maintenance](https://go.dev/wiki/Go-Release-Cycle#release-maintenance)
part of that page.

## Reporting a Vulnerability

Now defines the symbol type constants [STT_RELC], [STT_SRELC], and

Errors returned by [driver.Valuer] implementations are now wrapped for
improved error handling during operations like [DB.Query], [DB.Exec],