summaryrefslogtreecommitdiffstats
path: root/man/go-gopath-get.1
diff options
context:
space:
mode:
Diffstat (limited to 'man/go-gopath-get.1')
-rw-r--r--man/go-gopath-get.181
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).