1
0
mirror of https://github.com/golang/go synced 2024-11-27 00:21:21 -07:00
go/src
Robert Griesemer c55d5c887e cmd/compile/internal/types2: simplify use of TestManual
Running the TestManual test (for manual debugging) requires
user-provided files as input. Rather than using another flag
(-files) to provide these files, just use the (remaining)
command line arguments.

Change-Id: I9b20d9f1a6a7ce839bbd690c311ce3f0d0a10496
Reviewed-on: https://go-review.googlesource.com/c/go/+/315689
Trust: Robert Griesemer <gri@golang.org>
Run-TryBot: Robert Griesemer <gri@golang.org>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Robert Findley <rfindley@google.com>
2021-04-30 17:08:46 +00:00
..
archive archive/zip: only return directory once via io/fs.FS 2021-04-29 19:04:31 +00:00
bufio
builtin
bytes
cmd cmd/compile/internal/types2: simplify use of TestManual 2021-04-30 17:08:46 +00:00
compress
container
context all: fix spellings 2021-04-10 01:46:41 +00:00
crypto crypto/elliptic: store P-256 precomputed basepoint table in source 2021-04-29 20:23:35 +00:00
database/sql all: fix spellings 2021-04-10 01:46:41 +00:00
debug all: do not test internal linking on windows/arm64 2021-04-23 21:48:37 +00:00
embed
encoding encoding/csv: add FieldPos method 2021-04-29 17:47:48 +00:00
errors
expvar
flag
fmt
go go/ast: print CommentMap contents in source order 2021-04-30 16:04:36 +00:00
hash all: remove redundant spaces before . and , 2021-04-20 00:49:17 +00:00
html
image
index/suffixarray
internal cmd/compile, internal/abi: add FuncPCABIxxx intrinsics 2021-04-23 21:05:39 +00:00
io io/fs: document that caller can modify slice returned by ReadFile 2021-04-21 16:46:52 +00:00
log
math math: increase precision of math.SmallestNonzeroFloat64 2021-04-30 00:13:38 +00:00
mime mime: keep builtinTypesLower sorted alphabetically 2021-04-15 10:21:10 +00:00
net net/url: add Values.Has 2021-04-30 16:48:56 +00:00
os os: don't check non-nil err twice in Symlink on windows 2021-04-27 15:50:45 +00:00
path path/filepath: replace os.MkdirTemp with T.TempDir 2021-04-10 08:13:32 +00:00
plugin
reflect reflect: allow conversion from slice to array ptr 2021-04-21 00:54:39 +00:00
regexp
runtime cmd/compile, runtime: emit only GC data for stack objects 2021-04-30 00:08:50 +00:00
sort
strconv strconv: remove unused extfloat (Grisu3) ftoa code 2021-04-27 17:03:53 +00:00
strings
sync Revert "sync: improve sync.Pool object stealing" 2021-04-26 18:54:39 +00:00
syscall syscall: move TestForegroundSignal create call out of goroutine 2021-04-27 19:12:41 +00:00
testdata
testing testing: add -shuffle=off|on|N to alter the execution order of tests and benchmarks 2021-04-28 16:06:21 +00:00
text text/template/parse: add a mode to skip func-check on parsing 2021-04-19 16:49:40 +00:00
time time: increase slop for TestTicker 2021-04-27 19:37:31 +00:00
unicode
unsafe spec: add unsafe.Add and unsafe.Slice 2021-04-22 22:03:10 +00:00
vendor cmd/vendor: get golang.org/x/tools@f946a157eef 2021-04-23 05:38:47 +00:00
all.bash
all.bat
all.rc
bootstrap.bash
buildall.bash
clean.bash
clean.bat
clean.rc
cmp.bash
go.mod cmd/vendor: get golang.org/x/tools@f946a157eef 2021-04-23 05:38:47 +00:00
go.sum cmd/vendor: get golang.org/x/tools@f946a157eef 2021-04-23 05:38:47 +00:00
make.bash
make.bat
Make.dist
make.rc
race.bash
race.bat
README.vendor
run.bash
run.bat
run.rc

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.

In GOPATH mode, imports of vendored packages are resolved to these
directories following normal vendor directory logic
(see golang.org/s/go15vendor).

In module mode, std and cmd are modules (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",
an import of "golang.org/x/crypto/cryptobyte" resolves to
"vendor/golang.org/x/crypto/cryptobyte". When a package with the
same path is imported from a package outside std or cmd, it will
be resolved normally. Consequently, a binary may be built with two
copies of a package at different versions if the package is
imported normally and vendored by the standard library.

Vendored packages are internally renamed with a "vendor/" prefix
to preserve the invariant that all packages have distinct paths.
This is necessary to avoid compiler and linker conflicts. Adding
a "vendor/" prefix also maintains the invariant that standard
library packages begin with a dotless path element.

The module requirements of std and cmd do not influence version
selection in other modules. They are only considered when running
module commands like 'go get' and 'go mod vendor' from a directory
in GOROOT/src.

Maintaining vendor directories
==============================

Before updating vendor directories, ensure that module mode is enabled.
Make sure GO111MODULE=off is not set ('on' or 'auto' should work).

Requirements may be added, updated, and removed with 'go get'.
The vendor directory may be updated with 'go mod vendor'.
A typical sequence might be:

    cd src
    go get -d golang.org/x/net@latest
    go mod tidy
    go mod vendor

Use caution when passing '-u' to 'go get'. The '-u' flag updates
modules providing all transitively imported packages, not only
the module providing the target package.

Note that 'go mod vendor' only copies packages that are transitively
imported by packages in the current module. If a new package is needed,
it should be imported before running 'go mod vendor'.