diff options
author | Andrew Gerrand <adg@golang.org> | 2011-06-20 16:39:16 +1000 |
---|---|---|
committer | Andrew Gerrand <adg@golang.org> | 2011-06-20 16:39:16 +1000 |
commit | f22e5cfc6d58fec0f130957af6a0e30b75565d24 (patch) | |
tree | 4e2f66cf916efd3796dfbf04e06a2125b91c8d45 | |
parent | b7b8f2b0862061e4ca67a6157c30c0880dda9e54 (diff) | |
download | go-f22e5cfc6d58fec0f130957af6a0e30b75565d24.tar.gz go-f22e5cfc6d58fec0f130957af6a0e30b75565d24.zip |
goinstall: update doc.go
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/4645048
-rw-r--r-- | src/cmd/goinstall/doc.go | 24 |
1 files changed, 14 insertions, 10 deletions
diff --git a/src/cmd/goinstall/doc.go b/src/cmd/goinstall/doc.go index 649117be07..8f4648c3e7 100644 --- a/src/cmd/goinstall/doc.go +++ b/src/cmd/goinstall/doc.go @@ -41,9 +41,17 @@ Another common idiom is to use to update, recompile, and reinstall all goinstalled packages. The source code for a package with import path foo/bar is expected -to be in the directory $GOROOT/src/pkg/foo/bar/. If the import -path refers to a code hosting site, goinstall will download the code -if necessary. The recognized code hosting sites are: +to be in the directory $GOPATH/src/foo/bar/ or $GOROOT/src/pkg/foo/bar/. +(See the discussion of GOPATH below for more detail.) + +If the package source is not found locally and the import path begins +with a domain name, goinstall attempts to detect a remote source repository +(Bazaar, Git, Mercurial, or Subversion). If a supported repository is found, +goinstall uses the appropriate tool to download the source code. + +If the import path refers to a known code hosting site, goinstall skips the +repository detection and downloads the code directly. +The recognized code hosting sites are: BitBucket (Mercurial) @@ -63,7 +71,7 @@ if necessary. The recognized code hosting sites are: import "project.googlecode.com/svn/trunk" import "project.googlecode.com/svn/trunk/sub/directory" - Launchpad + Launchpad (Bazaar) import "launchpad.net/project" import "launchpad.net/project/series" @@ -87,7 +95,7 @@ system, typically HEAD for git, tip for Mercurial. After a successful download and installation of a publicly accessible remote package, goinstall reports the installation to godashboard.appspot.com, which increments a count associated with the package and the time -of its most recent installation. This mechanism powers the package list +of its most recent installation. This mechanism powers the package list at http://godashboard.appspot.com/package, allowing Go programmers to learn about popular packages that might be worth looking at. The -dashboard=false flag disables this reporting. @@ -96,11 +104,7 @@ By default, goinstall prints output only when it encounters an error. The -v flag causes goinstall to print information about packages being considered and installed. -Goinstall does not attempt to be a replacement for make. -Instead, it invokes "make install" after locating the package sources. -For local packages without a Makefile and all remote packages, -goinstall creates and uses a temporary Makefile constructed from -the import path and the list of Go files in the package. +Goinstall does not use make. Makefiles are ignored by goinstall. The GOPATH Environment Variable |