diff options
Diffstat (limited to 'man/go-gopath-get.1')
-rw-r--r-- | man/go-gopath-get.1 | 81 |
1 files changed, 81 insertions, 0 deletions
diff --git a/man/go-gopath-get.1 b/man/go-gopath-get.1 new file mode 100644 index 0000000..36fdf75 --- /dev/null +++ b/man/go-gopath-get.1 @@ -0,0 +1,81 @@ +.\" Hey, EMACS: -*- nroff -*- +.TH GO-GOPATH-GET 1 "2021-10-15" +.\" Please adjust this date whenever revising the manpage. +.SH NAME +go-get \- legacy GOPATH go get +.SH SYNOPSIS +The 'go get' command changes behavior depending on whether the +go command is running in module-aware mode or legacy GOPATH mode. +This help text, accessible as 'go help gopath-get' even in module-aware mode, +describes 'go get' as it operates in legacy GOPATH mode. +.P +.B go get +.RB [\|\-d\|] +.RB [\|\-f\|] +.RB [\|\-t\|] +.RB [\|\-u\|] +.RB [\|\-v\|] +.RB [\|\-fix\|] +.RI [ "build flags" ] +.RI [ packages ] +.SH DESCRIPTION +Get downloads the packages named by the import paths, along with their +dependencies. It then installs the named packages, like 'go install'. +.TP +.B \-d +The \-d flag instructs get to stop after downloading the packages; that is, +it instructs get not to install the packages. +.TP +.B \-f +The \-f flag, valid only when \-u is set, forces get \-u not to verify that +each package has been checked out from the source control repository +implied by its import path. This can be useful if the source is a local fork +of the original. +.TP +.B \-fix +The \-fix flag instructs get to run the fix tool on the downloaded packages +before resolving dependencies or building the code. +.TP +.B \-t +The \-t flag instructs get to also download the packages required to build +the tests for the specified packages. +.TP +.B \-u +The \-u flag instructs get to use the network to update the named packages +and their dependencies. By default, get uses the network to check out +missing packages but does not use it to look for updates to existing packages. +.TP +.B \-v +The \-v flag enables verbose progress and debug output. +.P +Get also accepts build flags to control the installation. +See \fBgo-build\fP(1). +.P +When checking out a new package, get creates the target directory +GOPATH/src/<import-path>. If the GOPATH contains multiple entries, +get uses the first one. For more details see: 'go help gopath'. +.P +When checking out or updating a package, get looks for a branch or tag +that matches the locally installed version of Go. The most important +rule is that if the local installation is running version "go1", get +searches for a branch or tag named "go1". If no such version exists +it retrieves the default branch of the package. +.P +When go get checks out or updates a Git repository, +it also updates any git submodules referenced by the repository. +.P +Get never checks out or updates code stored in vendor directories. +.P +For more about specifying packages, see \fBgo-packages\fP(7). +.P +For more about how 'go get' finds source code to download, see \fBgo-remote\fP(7). +.SH SEE ALSO +.BR go-build (1), +.BR go-install (1), +.BR go-clean (1). +.SH AUTHOR +This manual page was written by Michael Stapelberg <stapelberg@debian.org> +and is maintained by the +Debian Go Compiler Team <team+go-compiler@tracker.debian.org> +based on the output of 'go help gopath-get' +for the Debian project (and may be used by others). |