go/src
Russ Cox 84e2bd611f [dev.regabi] cmd/compile: introduce cmd/compile/internal/ir [generated]
If we want to break up package gc at all, we will need to move
the compiler IR it defines into a separate package that can be
imported by packages that gc itself imports. This CL does that.
It also removes the TINT8 etc aliases so that all code is clear
about which package things are coming from.

This CL is automatically generated by the script below.
See the comments in the script for details about the changes.

[git-generate]
cd src/cmd/compile/internal/gc

rf '
        # These names were never fully qualified
        # when the types package was added.
        # Do it now, to avoid confusion about where they live.
        inline -rm \
                Txxx \
                TINT8 \
                TUINT8 \
                TINT16 \
                TUINT16 \
                TINT32 \
                TUINT32 \
                TINT64 \
                TUINT64 \
                TINT \
                TUINT \
                TUINTPTR \
                TCOMPLEX64 \
                TCOMPLEX128 \
                TFLOAT32 \
                TFLOAT64 \
                TBOOL \
                TPTR \
                TFUNC \
                TSLICE \
                TARRAY \
                TSTRUCT \
                TCHAN \
                TMAP \
                TINTER \
                TFORW \
                TANY \
                TSTRING \
                TUNSAFEPTR \
                TIDEAL \
                TNIL \
                TBLANK \
                TFUNCARGS \
                TCHANARGS \
                NTYPE \
                BADWIDTH

        # esc.go and escape.go do not need to be split.
        # Append esc.go onto the end of escape.go.
        mv esc.go escape.go

        # Pull out the type format installation from func Main,
        # so it can be carried into package ir.
        mv Main:/Sconv.=/-0,/TypeLinkSym/-1 InstallTypeFormats

        # Names that need to be exported for use by code left in gc.
        mv Isconst IsConst
        mv asNode AsNode
        mv asNodes AsNodes
        mv asTypesNode AsTypesNode
        mv basicnames BasicTypeNames
        mv builtinpkg BuiltinPkg
        mv consttype ConstType
        mv dumplist DumpList
        mv fdumplist FDumpList
        mv fmtMode FmtMode
        mv goopnames OpNames
        mv inspect Inspect
        mv inspectList InspectList
        mv localpkg LocalPkg
        mv nblank BlankNode
        mv numImport NumImport
        mv opprec OpPrec
        mv origSym OrigSym
        mv stmtwithinit StmtWithInit
        mv dump DumpAny
        mv fdump FDumpAny
        mv nod Nod
        mv nodl NodAt
        mv newname NewName
        mv newnamel NewNameAt
        mv assertRepresents AssertValidTypeForConst
        mv represents ValidTypeForConst
        mv nodlit NewLiteral

        # Types and fields that need to be exported for use by gc.
        mv nowritebarrierrecCallSym SymAndPos
        mv SymAndPos.lineno SymAndPos.Pos
        mv SymAndPos.target SymAndPos.Sym

        mv Func.lsym Func.LSym
        mv Func.setWBPos Func.SetWBPos
        mv Func.numReturns Func.NumReturns
        mv Func.numDefers Func.NumDefers
        mv Func.nwbrCalls Func.NWBRCalls

        # initLSym is an algorithm left behind in gc,
        # not an operation on Func itself.
        mv Func.initLSym initLSym

        mv nodeQueue NodeQueue
        mv NodeQueue.empty NodeQueue.Empty
        mv NodeQueue.popLeft NodeQueue.PopLeft
        mv NodeQueue.pushRight NodeQueue.PushRight

        # Many methods on Node are actually algorithms that
        # would apply to any node implementation.
        # Those become plain functions.
        mv Node.funcname FuncName
        mv Node.isBlank IsBlank
        mv Node.isGoConst isGoConst
        mv Node.isNil IsNil
        mv Node.isParamHeapCopy isParamHeapCopy
        mv Node.isParamStackCopy isParamStackCopy
        mv Node.isSimpleName isSimpleName
        mv Node.mayBeShared MayBeShared
        mv Node.pkgFuncName PkgFuncName
        mv Node.backingArrayPtrLen backingArrayPtrLen
        mv Node.isterminating isTermNode
        mv Node.labeledControl labeledControl
        mv Nodes.isterminating isTermNodes
        mv Nodes.sigerr fmtSignature
        mv Node.MethodName methodExprName
        mv Node.MethodFunc methodExprFunc
        mv Node.IsMethod IsMethod

        # Every node will need to implement RawCopy;
        # Copy and SepCopy algorithms will use it.
        mv Node.rawcopy Node.RawCopy
        mv Node.copy Copy
        mv Node.sepcopy SepCopy

        # Extract Node.Format method body into func FmtNode,
        # but leave method wrapper behind.
        mv Node.Format:0,$ FmtNode

        # Formatting helpers that will apply to all node implementations.
        mv Node.Line Line
        mv Node.exprfmt exprFmt
        mv Node.jconv jconvFmt
        mv Node.modeString modeString
        mv Node.nconv nconvFmt
        mv Node.nodedump nodeDumpFmt
        mv Node.nodefmt nodeFmt
        mv Node.stmtfmt stmtFmt

	# Constant support needed for code moving to ir.
        mv okforconst OKForConst
        mv vconv FmtConst
        mv int64Val Int64Val
        mv float64Val Float64Val
        mv Node.ValueInterface ConstValue

        # Organize code into files.
        mv LocalPkg BuiltinPkg ir.go
        mv NumImport InstallTypeFormats Line fmt.go
        mv syntax.go Nod NodAt NewNameAt Class Pxxx PragmaFlag Nointerface SymAndPos \
                AsNode AsTypesNode BlankNode OrigSym \
                Node.SliceBounds Node.SetSliceBounds Op.IsSlice3 \
                IsConst Node.Int64Val Node.CanInt64 Node.Uint64Val Node.BoolVal Node.StringVal \
                Node.RawCopy SepCopy Copy \
                IsNil IsBlank IsMethod \
                Node.Typ Node.StorageClass node.go
        mv ConstType ConstValue Int64Val Float64Val AssertValidTypeForConst ValidTypeForConst NewLiteral idealType OKForConst val.go

        # Move files to new ir package.
        mv bitset.go class_string.go dump.go fmt.go \
                ir.go node.go op_string.go val.go \
                sizeof_test.go cmd/compile/internal/ir
'

: # fix mkbuiltin.go to generate the changes made to builtin.go during rf
sed -i '' '
        s/\[T/[types.T/g
        s/\*Node/*ir.Node/g
        /internal\/types/c \
                fmt.Fprintln(&b, `import (`) \
                fmt.Fprintln(&b, `      "cmd/compile/internal/ir"`) \
                fmt.Fprintln(&b, `      "cmd/compile/internal/types"`) \
                fmt.Fprintln(&b, `)`)
' mkbuiltin.go
gofmt -w mkbuiltin.go

: # update cmd/dist to add internal/ir
cd ../../../dist
sed -i '' '/compile.internal.gc/a\
        "cmd/compile/internal/ir",
' buildtool.go
gofmt -w buildtool.go

: # update cmd/compile TestFormats
cd ../..
go install std cmd
cd cmd/compile
go test -u || go test  # first one updates but fails; second passes

Change-Id: I5f7caf6b20629b51970279e81231a3574d5b51db
Reviewed-on: https://go-review.googlesource.com/c/go/+/273008
Trust: Russ Cox <rsc@golang.org>
Reviewed-by: Matthew Dempsky <mdempsky@google.com>
2020-11-25 16:53:33 +00:00
..
archive archive/zip: fix documentation to mention fs.FS interface 2020-11-07 03:52:47 +00:00
bufio all: update references to symbols moved from io/ioutil to io 2020-10-20 18:41:18 +00:00
builtin
bytes bytes: add example for (*Buffer).Bytes 2020-11-11 20:51:00 +00:00
cmd [dev.regabi] cmd/compile: introduce cmd/compile/internal/ir [generated] 2020-11-25 16:53:33 +00:00
compress all: fix quoting for compress/bzip2 and time's godoc 2020-10-23 21:57:39 +00:00
container
context
crypto crypto/tls: de-prioritize AES-GCM ciphers when lacking hardware support 2020-11-10 01:40:27 +00:00
database/sql database/sql, runtime: correct *.Fatal inside goroutines in tests 2020-10-31 20:30:19 +00:00
debug cmd/link: emit include directories in DWARF line table prologue 2020-10-30 18:01:54 +00:00
embed cmd/go: add //go:embed support 2020-10-29 16:26:43 +00:00
encoding encoding/asn1: optimize asn1.Unmarshal 2020-11-09 21:36:24 +00:00
errors all: update references to symbols moved from os to io/fs 2020-10-20 02:32:42 +00:00
expvar
flag all: update references to symbols moved from io/ioutil to io 2020-10-20 18:41:18 +00:00
fmt fmt: explain how Formatter interface affects verbs and flags 2020-10-13 19:15:53 +00:00
go [dev.regabi] go/constant: avoid heap allocations in match 2020-11-24 19:17:49 +00:00
hash hash/crc32: fix race between lazy Castagnoli init and Update/Write 2020-10-13 00:31:47 +00:00
html encoding/json: add "json: " prefix to SyntaxError messages 2020-10-21 18:50:01 +00:00
image all: update references to symbols moved from io/ioutil to io 2020-10-20 18:41:18 +00:00
index/suffixarray all: update references to symbols moved from os to io/fs 2020-10-20 02:32:42 +00:00
internal net, internal/poll: reset value before adding in minor kernel version 2020-11-20 04:21:00 +00:00
io io/fs: make WalkDirFunc parameter name consistent with doc comment 2020-11-19 21:51:34 +00:00
log log/syslog: set local to true if network is any of "unix", or "unixgram" 2020-10-25 05:19:20 +00:00
math math/big: fix shift for recursive division 2020-11-12 20:42:40 +00:00
mime mime: look up mime types on Arch Linux 2020-10-27 15:22:02 +00:00
net net, internal/poll: reset value before adding in minor kernel version 2020-11-20 04:21:00 +00:00
os os: gofmt 2020-11-12 10:22:50 +00:00
path io/fs: add WalkDir 2020-11-06 19:42:05 +00:00
plugin
reflect reflect: update NumMethod doc for interface type 2020-11-03 00:50:57 +00:00
regexp
runtime runtime/metrics: tweak wording of stack and unused memory metrics 2020-11-23 19:58:25 +00:00
sort sort: fix grammar in updated Less comment 2020-10-17 22:58:33 +00:00
strconv [dev.regabi] strconv: add to bootstrap packages 2020-11-24 19:42:42 +00:00
strings strings: complete Reader doc string 2020-10-30 00:23:50 +00:00
sync sync: use 386 instead of x86-32 to refer to the 32 bit x86 architecture 2020-11-23 05:57:35 +00:00
syscall syscall: add DLLError.Unwrap function 2020-11-21 07:37:02 +00:00
testdata
testing testing: reduce memory allocation in Helper 2020-11-11 20:48:31 +00:00
text all: update references to symbols moved from io/ioutil to io 2020-10-20 18:41:18 +00:00
time time: in NewTicker, document that the 1st tick comes after d 2020-11-18 04:43:50 +00:00
unicode unicode/utf8: document the handling of runes out of range in EncodeRune 2020-09-19 09:43:15 +00:00
unsafe
vendor all: update vendored dependencies for Go 1.16 release 2020-11-11 06:26:05 +00:00
all.bash
all.bat
all.rc
bootstrap.bash
buildall.bash src/buildall.bash: remove linux-386-387 target 2020-10-05 21:08:03 +00:00
clean.bash
clean.bat
clean.rc
cmp.bash
go.mod all: update vendored dependencies for Go 1.16 release 2020-11-11 06:26:05 +00:00
go.sum all: update vendored dependencies for Go 1.16 release 2020-11-11 06:26:05 +00:00
make.bash make.bash: avoid warning when bootstrap doesn't support GOOS/GOARCH 2020-09-21 16:50:07 +00:00
make.bat make.bat: fix compare between GOROOT and srcdir paths, when either contains whitespace. 2020-09-13 19:17:09 +00:00
Make.dist
make.rc
race.bash race.bash: add darwin/arm64 2020-11-04 21:02:29 +00:00
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'.