qbit/go
1
0
Fork 0
mirror of https://github.com/golang/go synced 2024-11-22 04:04:40 -07:00
Code Releases Activity

goinstall: update doc.go

Browse Source 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/4645048
This commit is contained in:
Andrew Gerrand 2011-06-20 16:39:16 +10:00
parent b7b8f2b086
commit f22e5cfc6d
1 changed files with 14 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
src/cmd/goinstall/doc.go
View File

@ -41,9 +41,17 @@ Another common idiom is to use
to update, recompile, and reinstall all goinstalled packages. to update, recompile, and reinstall all goinstalled packages.
The source code for a package with import path foo/bar is expected 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 to be in the directory $GOPATH/src/foo/bar/ or $GOROOT/src/pkg/foo/bar/.
path refers to a code hosting site, goinstall will download the code (See the discussion of GOPATH below for more detail.)
if necessary. The recognized code hosting sites are:
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) 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"
import "project.googlecode.com/svn/trunk/sub/directory" import "project.googlecode.com/svn/trunk/sub/directory"
Launchpad Launchpad (Bazaar)
import "launchpad.net/project" import "launchpad.net/project"
import "launchpad.net/project/series" 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 After a successful download and installation of a publicly accessible
remote package, goinstall reports the installation to godashboard.appspot.com, remote package, goinstall reports the installation to godashboard.appspot.com,
which increments a count associated with the package and the time 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 at http://godashboard.appspot.com/package, allowing Go programmers
to learn about popular packages that might be worth looking at. to learn about popular packages that might be worth looking at.
The -dashboard=false flag disables this reporting. 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 The -v flag causes goinstall to print information about packages
being considered and installed. being considered and installed.
Goinstall does not attempt to be a replacement for make. Goinstall does not use make. Makefiles are ignored by goinstall.
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.
The GOPATH Environment Variable The GOPATH Environment Variable