go-path(7) [debian man page]

GO-PATH(7)						 Miscellaneous Information Manual						GO-PATH(7)

NAME

       go - tool for managing Go source code

DESCRIPTION

       The Go path is used to resolve import statements.  It is implemented by and documented in the go/build package.

       The  GOPATH  environment variable lists places to look for Go code.  On Unix, the value is a colon-separated string.  On Windows, the value
       is a semicolon-separated string.  On Plan 9, the value is a list.

       GOPATH must be set to build and install packages outside the standard Go tree.

       Each directory listed in GOPATH must have a prescribed structure:

       The src/ directory holds source code.  The path below 'src' determines the import path or executable name.

       The pkg/ directory holds installed package objects.  As in the Go tree, each target operating system and architecture pair has its own sub-
       directory of pkg (pkg/GOOS_GOARCH).

       If DIR is a directory listed in the GOPATH, a package with source in DIR/src/foo/bar can be imported as "foo/bar" and has its compiled form
       installed to "DIR/pkg/GOOS_GOARCH/foo/bar.a".

       The bin/ directory holds compiled commands.  Each command is named for its source directory, but only the final	element,  not  the  entire
       path.   That is, the command with source in DIR/src/foo/quux is installed into DIR/bin/quux, not DIR/bin/foo/quux.  The foo/ is stripped so
       that you can add DIR/bin to your PATH to get at the installed commands.	If the GOBIN environment variable is set, commands  are  installed
       to the directory it names instead of DIR/bin.

       Here's an example directory layout:

	   GOPATH=/home/user/gocode

	   /home/user/gocode/
	       src/
		   foo/
		       bar/		  (go code in package bar)
			   x.go
		       quux/		  (go code in package main)
			   y.go
	       bin/
		   quux 		  (installed command)
	       pkg/
		   linux_amd64/
		       foo/
			   bar.a	  (installed package object)

       Go  searches  each  directory  listed in GOPATH to find source code, but new packages are always downloaded into the first directory in the
       list.

AUTHOR

       This manual page was written by Michael Stapelberg <stapelberg@debian.org>, for the Debian project (and may be used by others).

								    2012-05-13								GO-PATH(7)

Check Out this Related Man Page

GO-CLEAN(1)						      General Commands Manual						       GO-CLEAN(1)

NAME

       go - tool for managing Go source code

SYNOPSIS

       go clean [-i] [-r] [-n] [-x] [ packages ]

DESCRIPTION

       Clean  removes  object  files from package source directories.  The go command builds most objects in a temporary directory, so go clean is
       mainly concerned with object files left by other tools or by manual invocations of go build.

       Specifically, clean removes the following files from each of the source directories corresponding to the import paths:

       _obj/  old object directory, left from Makefiles

       _test/ old test directory, left from Makefiles

       _testmain.go
	      old gotest file, left from Makefiles

       test.out
	      old test log, left from Makefiles

       build.out
	      old test log, left from Makefiles

       *.[568ao]
	      object files, left from Makefiles

       DIR(.exe)
	      from go build

       DIR.test(.exe)
	      from go test -c

       MAINFILE(.exe)
	      from go build MAINFILE.go

       In the list, DIR represents the final path element of the directory, and MAINFILE is the base name of any Go source file in  the  directory
       that is not included when building the package.

OPTIONS

       -i     The -i flag causes clean to remove the corresponding installed archive or binary (what 'go install' would create).

       -n     The -n flag causes clean to print the remove commands it would execute, but not run them.

       -r     The -r flag causes clean to be applied recursively to all the dependencies of the packages named by the import paths.

       -x     The -x flag causes clean to print remove commands as it executes them.

       For more about specifying packages, see go-packages(7).

AUTHOR

       This manual page was written by Michael Stapelberg <stapelberg@debian.org>, for the Debian project (and may be used by others).

								    2012-05-13							       GO-CLEAN(1)

Linux and UNIX Man Pages

go-path(7) [debian man page]

Check Out this Related Man Page