Vendoring in std and cmd
========================

The Go command maintains copies of external packages needed by the
standard library in the src/vendor and src/cmd/vendor directories.

There are two modules, std and cmd, defined in src/go.mod and
src/cmd/go.mod. When a package outside std or cmd is imported
by a package inside std or cmd, the import path is interpreted
as if it had a "vendor/" prefix. For example, within "crypto/tls",

/bin/
/build.out
/doc/articles/wiki/*.bin
/goinstall.log
/last-change
/misc/cgo/life/run.out
/misc/cgo/stdio/run.out
/misc/cgo/testso/main
/pkg/
/src/*.*/
/src/cmd/cgo/zdefaultcc.go
/src/cmd/dist/dist
/src/cmd/go/internal/cfg/zdefaultcc.go
/src/cmd/internal/objabi/zbootstrap.go
/src/go/build/zcgo.go
/src/go/doc/headscan
/src/internal/buildcfg/zbootstrap.go
/src/runtime/internal/sys/zversion.go
/src/unicode/maketables

Packages or programs may define additional settings for internal debugging purposes;
for example,
see the [runtime documentation](/pkg/runtime#hdr-Environment_Variables)
and the [go command documentation](/cmd/go#hdr-Build_and_test_caching).

### Go 1.23

Go 1.23 changed the channels created by package time to be unbuffered
(synchronous), which makes correct use of the [`Timer.Stop`](/pkg/time/#Timer.Stop)

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"

    > cd doc
    > rm -r next/*
    > cp -r initial/* next

Then edit `next/1-intro.md` to refer to the next version.

To prepare the release notes for a release, run `golang.org/x/build/cmd/relnote generate`.

pkg net, method (*OpError) Unwrap() error
pkg net, type DNSError struct, IsNotFound bool
pkg net, type ListenConfig struct, KeepAlive time.Duration
pkg net/url, method (*Error) Unwrap() error
pkg os/exec, method (*Cmd) String() string
pkg os/exec, method (*Error) Unwrap() error
pkg os, func UserConfigDir() (string, error)
pkg os, method (*LinkError) Unwrap() error
pkg os, method (*PathError) Unwrap() error

pkg os/exec, type Cmd struct
pkg os/exec, type Cmd struct, Args []string
pkg os/exec, type Cmd struct, Dir string
pkg os/exec, type Cmd struct, Env []string
pkg os/exec, type Cmd struct, ExtraFiles []*os.File
pkg os/exec, type Cmd struct, Path string
pkg os/exec, type Cmd struct, Process *os.Process
pkg os/exec, type Cmd struct, ProcessState *os.ProcessState

of Go in effect in the referring file. (The effective version is determined
by the `go` directive in the file's enclosing `go.mod` file, and
by any [`//go:build` constraints](https://pkg.go.dev/cmd/go#hdr-Build_constraints)
in the file.)

For example, it will report a diagnostic for a reference to the
`reflect.TypeFor` function (introduced in go1.22) from a file in a
module whose go.mod file specifies `go 1.21`.

pkg syscall (linux-386), const LINUX_REBOOT_CMD_CAD_OFF = 0
pkg syscall (linux-386), const LINUX_REBOOT_CMD_CAD_ON = 2309737967
pkg syscall (linux-386), const LINUX_REBOOT_CMD_HALT = 3454992675
pkg syscall (linux-386), const LINUX_REBOOT_CMD_KEXEC = 1163412803
pkg syscall (linux-386), const LINUX_REBOOT_CMD_POWER_OFF = 1126301404
pkg syscall (linux-386), const LINUX_REBOOT_CMD_RESTART = 19088743

# CL 106460044 debug/plan9obj, cmd/addr2line: on Plan 9 use a.out header, Aram Hăvărneanu <******@****.***>
pkg debug/plan9obj, type FileHeader struct, HdrSize uint64
pkg debug/plan9obj, type FileHeader struct, LoadAddress uint64

# CL 122960043 encoding/xml: add InputOffset method to Decoder, Russ Cox <******@****.***>
pkg encoding/xml, method (*Decoder) InputOffset() int64