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"

# Run go tool dist to install a command.
# The -v causes dist to print the name of each directory as it runs.
# The -vv causes dist to print each build command as it runs.
# go tool dist clean cleans all directories, not just this one,
# but it's as close as we can get.

# Default target (first).
install:
	go tool dist install -v

verbose:
	go tool dist install -vv

clean:

    "This change modifies Go to ___________"
  + Lowercase verb after the colon
  + No trailing period
  + Keep the title as short as possible. ideally under 76 characters or shorter
+ No Markdown
+ The first PR comment (this one) is wrapped at 76 characters, unless it's
  really needed (ASCII art, table, or long link)
+ If there is a corresponding issue, add either `Fixes #1234` or `Updates #1234`
  (the latter if this is not a complete fix) to this comment

because it documents the full list of known GODEBUG settings,
which are tied to a specific release.
-->

## Introduction {#intro}

Go's emphasis on backwards compatibility is one of its key strengths.
There are, however, times when we cannot maintain complete compatibility.
If code depends on buggy (including insecure) behavior,
then fixing the bug will break that code.

The main effect of this change is that Go now guarantees
that for any call to a `Reset` or `Stop` method, no stale values
prepared before that call will be sent or received after the call.
Earlier versions of Go used channels with a one-element buffer,
making it difficult to use `Reset` and `Stop` correctly.
A visible effect of this change is that `len` and `cap` of timer channels
now returns 0 instead of 1, which may affect programs that

pkg syscall (linux-386), const IFF_NOARP ideal-int
pkg syscall (linux-386), const IFF_NOTRAILERS ideal-int
pkg syscall (linux-386), const IFF_NO_PI ideal-int
pkg syscall (linux-386), const IFF_ONE_QUEUE ideal-int
pkg syscall (linux-386), const IFF_POINTOPOINT ideal-int
pkg syscall (linux-386), const IFF_PORTSEL ideal-int
pkg syscall (linux-386), const IFF_PROMISC ideal-int

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

pkg syscall (linux-386), const IFF_NOARP = 128
pkg syscall (linux-386), const IFF_NOTRAILERS = 32
pkg syscall (linux-386), const IFF_NO_PI = 4096
pkg syscall (linux-386), const IFF_ONE_QUEUE = 8192
pkg syscall (linux-386), const IFF_POINTOPOINT = 16
pkg syscall (linux-386), const IFF_PORTSEL = 8192
pkg syscall (linux-386), const IFF_PROMISC = 256
pkg syscall (linux-386), const IFF_RUNNING = 64

pkg syscall (linux-arm-cgo), const IFF_NOARP ideal-int
pkg syscall (linux-arm-cgo), const IFF_NOTRAILERS ideal-int
pkg syscall (linux-arm-cgo), const IFF_NO_PI ideal-int
pkg syscall (linux-arm-cgo), const IFF_ONE_QUEUE ideal-int
pkg syscall (linux-arm-cgo), const IFF_POINTOPOINT ideal-int
pkg syscall (linux-arm-cgo), const IFF_PORTSEL ideal-int
pkg syscall (linux-arm-cgo), const IFF_PROMISC ideal-int