[Pkg-golang-commits] [golang-defaults] 01/01: initial commit
Michael Hudson-Doyle
mwhudson-guest at moszumanska.debian.org
Wed Apr 13 23:44:19 UTC 2016
This is an automated email from the git hooks/post-receive script.
mwhudson-guest pushed a commit to branch debian-sid
in repository golang-defaults.
commit 7714a39df360348ad1832b9752c57e579cf5a8b9
Author: Michael Hudson-Doyle <michael.hudson at canonical.com>
Date: Thu Mar 3 12:13:03 2016 +1300
initial commit
---
debian/changelog | 5 ++
debian/compat | 1 +
debian/control | 136 ++++++++++++++++++++++++++++++++++
debian/copyright | 56 ++++++++++++++
debian/golang-any.links.gccgo | 3 +
debian/golang-go.links | 4 +
debian/golang-go.manpages | 1 +
debian/golang-go.preinst | 22 ++++++
debian/golang-src.links | 2 +
debian/helpers/getgoarches.pl | 14 ++++
debian/helpers/getver.pl | 15 ++++
debian/rules | 26 +++++++
debian/source/format | 1 +
man/go-build.1 | 80 ++++++++++++++++++++
man/go-clean.1 | 82 +++++++++++++++++++++
man/go-env.1 | 21 ++++++
man/go-fix.1 | 25 +++++++
man/go-fmt.1 | 37 ++++++++++
man/go-get.1 | 59 +++++++++++++++
man/go-install.1 | 28 +++++++
man/go-list.1 | 104 ++++++++++++++++++++++++++
man/go-packages.7 | 66 +++++++++++++++++
man/go-path.7 | 77 ++++++++++++++++++++
man/go-remote.7 | 166 ++++++++++++++++++++++++++++++++++++++++++
man/go-run.1 | 24 ++++++
man/go-test.1 | 75 +++++++++++++++++++
man/go-testflag.7 | 87 ++++++++++++++++++++++
man/go-testfunc.7 | 63 ++++++++++++++++
man/go-tool.1 | 26 +++++++
man/go-version.1 | 13 ++++
man/go-vet.1 | 35 +++++++++
man/go.1 | 66 +++++++++++++++++
man/gofmt.1 | 108 +++++++++++++++++++++++++++
33 files changed, 1528 insertions(+)
diff --git a/debian/changelog b/debian/changelog
new file mode 100644
index 0000000..a394340
--- /dev/null
+++ b/debian/changelog
@@ -0,0 +1,5 @@
+golang-defaults (2:1.6-2) UNRELEASED; urgency=medium
+
+ * Initial release. (Closes: #818415)
+
+ -- Michael Hudson-Doyle <michael.hudson at canonical.com> Thu, 03 Mar 2016 12:09:51 +1300
diff --git a/debian/compat b/debian/compat
new file mode 100644
index 0000000..ec63514
--- /dev/null
+++ b/debian/compat
@@ -0,0 +1 @@
+9
diff --git a/debian/control b/debian/control
new file mode 100644
index 0000000..fdfdd3d
--- /dev/null
+++ b/debian/control
@@ -0,0 +1,136 @@
+Source: golang-defaults
+Section: devel
+Priority: optional
+Maintainer: Ubuntu Developers <ubuntu-devel-discuss at lists.ubuntu.com>
+Build-Depends: debhelper (>= 9), dh-exec
+Standards-Version: 3.9.6
+Homepage: https://golang.org
+
+Package: golang-go
+Architecture: amd64 arm64 armel armhf i386 ppc64 ppc64el
+Depends: golang-${golang:GOVER}-go,
+ golang-src (>= ${source:Version}),
+ ${misc:Depends}
+Breaks: gccgo-5 (<< 5.3.1-12),
+ golang-go (<= 2:1.6.1-2),
+ golang-go-darwin-386,
+ golang-go-darwin-amd64,
+ golang-go-freebsd-386,
+ golang-go-freebsd-amd64,
+ golang-go-freebsd-arm,
+ golang-go-linux-386,
+ golang-go-linux-amd64,
+ golang-go-linux-arm,
+ golang-go-netbsd-386,
+ golang-go-netbsd-amd64,
+ golang-go-windows-386,
+ golang-go-windows-amd64,
+ golang-go.tools (<< 1:0.0~git20151026.0.0f9d71c-1~),
+ golang-golang-x-tools (<< 1:0.0~git20151026.0.0f9d71c-1~)
+Replaces: golang-go-darwin-386,
+ golang-go-darwin-amd64,
+ golang-go-freebsd-386,
+ golang-go-freebsd-amd64,
+ golang-go-freebsd-arm,
+ golang-go-linux-386,
+ golang-go-linux-amd64,
+ golang-go-linux-arm,
+ golang-go-netbsd-386,
+ golang-go-netbsd-amd64,
+ golang-go-windows-386,
+ golang-go-windows-amd64,
+ golang-go.tools (<< 1:0.0~git20151026.0.0f9d71c-1~),
+ golang-golang-x-tools (<< 1:0.0~git20151026.0.0f9d71c-1~)
+Description: Go programming language compiler, linker, compiled stdlib
+ The Go programming language is an open source project to make programmers more
+ productive. Go is expressive, concise, clean, and efficient. Its concurrency
+ mechanisms make it easy to write programs that get the most out of multicore
+ and networked machines, while its novel type system enables flexible and
+ modular program construction. Go compiles quickly to machine code yet has the
+ convenience of garbage collection and the power of run-time reflection. It's a
+ fast, statically typed, compiled language that feels like a dynamically typed,
+ interpreted language.
+ .
+ This is a dependency package that depends on the default Go toolchain and
+ compiled standard library. It is only built on architectures that have a
+ native toolchain ("gc compiler"). Packages that want to build with whichever
+ of gc or gccgo is available should depend on golang-any.
+
+Package: golang-any
+Architecture: any
+Depends: gccgo [!armel !armhf !amd64 !i386 !arm64 !ppc64 !ppc64el],
+ golang-go [armel armhf amd64 i386 arm64 ppc64 ppc64el],
+ ${misc:Depends}
+Description: Go programming language compiler, linker, compiled stdlib
+ The Go programming language is an open source project to make programmers more
+ productive. Go is expressive, concise, clean, and efficient. Its concurrency
+ mechanisms make it easy to write programs that get the most out of multicore
+ and networked machines, while its novel type system enables flexible and
+ modular program construction. Go compiles quickly to machine code yet has the
+ convenience of garbage collection and the power of run-time reflection. It's a
+ fast, statically typed, compiled language that feels like a dynamically typed,
+ interpreted language.
+ .
+ This is a dependency package that depends on the default Go toolchain and
+ compiled standard library or gccgo on architectures that do not have a native
+ toolchain ("gc compiler") port. Because the gccgo and Go releases are not on
+ the same schedule, it is not guaranteed that the version of the Go language
+ provided by the version of gccgo that this package depends upon will match the
+ version of this package.
+
+Package: golang-src
+Architecture: amd64 arm64 armel armhf i386 ppc64 ppc64el
+Depends: golang-${golang:GOVER}-src, ${misc:Depends}
+Description: Go programming language - source files
+ The Go programming language is an open source project to make programmers more
+ productive. Go is expressive, concise, clean, and efficient. Its concurrency
+ mechanisms make it easy to write programs that get the most out of multicore
+ and networked machines, while its novel type system enables flexible and
+ modular program construction. Go compiles quickly to machine code yet has the
+ convenience of garbage collection and the power of run-time reflection. It's a
+ fast, statically typed, compiled language that feels like a dynamically typed,
+ interpreted language.
+ .
+ This is a dependency package that depends on the default Go standard library
+ source code, which is needed for the go build process.
+
+Package: golang-doc
+Depends: golang-${golang:GOVER}-doc, golang-go, ${misc:Depends}
+Architecture: all
+Section: doc
+Description: Go programming language - documentation
+ The Go programming language is an open source project to make
+ programmers more productive. Go is expressive, concise, clean, and
+ efficient. Its concurrency mechanisms make it easy to write programs
+ that get the most out of multicore and networked machines, while its
+ novel type system enables flexible and modular program construction.
+ Go compiles quickly to machine code yet has the convenience of
+ garbage collection and the power of run-time reflection. It's a fast,
+ statically typed, compiled language that feels like a dynamically
+ typed, interpreted language.
+ .
+ This is a dependency package that depends on the default Go documentation. You
+ can view the formatted documentation by installing the golang-golang-x-tools
+ package, running "godoc --http=:6060", and then visiting
+ http://localhost:6060/doc/install.html.
+
+Package: golang
+Depends: golang-${golang:GOVER},
+ golang-doc (>= ${source:Version}),
+ golang-go (>= ${source:Version}),
+ golang-src (>= ${source:Version}),
+ ${misc:Depends}
+Architecture: all
+Description: Go programming language compiler - metapackage
+ The Go programming language is an open source project to make
+ programmers more productive. Go is expressive, concise, clean, and
+ efficient. Its concurrency mechanisms make it easy to write programs
+ that get the most out of multicore and networked machines, while its
+ novel type system enables flexible and modular program construction.
+ Go compiles quickly to machine code yet has the convenience of
+ garbage collection and the power of run-time reflection. It's a
+ fast, statically typed, compiled language that feels like a
+ dynamically typed, interpreted language.
+ .
+ This package is a metapackage that, when installed, guarantees
+ that (most of) a full Go development environment is installed.
diff --git a/debian/copyright b/debian/copyright
new file mode 100644
index 0000000..f4ec1e5
--- /dev/null
+++ b/debian/copyright
@@ -0,0 +1,56 @@
+Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
+Comment: This package is entirely derived from the debian/* files in
+ the golang packaging, so the copyright information has been copied
+ from there.
+
+Files: *
+Copyright: 2010 Ivan Wong <ivanwyc at gmail.com>
+ 2010 Ondřej Surý <ondrej at debian.org>
+ 2012 Michael Stapelberg <stapelberg at debian.org>
+ 2014 Canonical Ltd
+ 2014 Tianon Gravi <tianon at debian.org>
+License: Go
+
+License: Go
+ Copyright © 2009 The Go Authors. All rights reserved.
+ .
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions are
+ met:
+ .
+ * Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ * Redistributions in binary form must reproduce the above
+ copyright notice, this list of conditions and the following disclaimer
+ in the documentation and/or other materials provided with the
+ distribution.
+ * Neither the name of Google Inc. nor the names of its
+ contributors may be used to endorse or promote products derived from
+ this software without specific prior written permission.
+ .
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ .
+ Subject to the terms and conditions of this License, Google hereby
+ grants to You a perpetual, worldwide, non-exclusive, no-charge,
+ royalty-free, irrevocable (except as stated in this section) patent
+ license to make, have made, use, offer to sell, sell, import, and
+ otherwise transfer this implementation of Go, where such license
+ applies only to those patent claims licensable by Google that are
+ necessarily infringed by use of this implementation of Go. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that this
+ implementation of Go or a Contribution incorporated within this
+ implementation of Go constitutes direct or contributory patent
+ infringement, then any patent licenses granted to You under this
+ License for this implementation of Go shall terminate as of the date
+ such litigation is filed.
diff --git a/debian/golang-any.links.gccgo b/debian/golang-any.links.gccgo
new file mode 100755
index 0000000..fdbb5f1
--- /dev/null
+++ b/debian/golang-any.links.gccgo
@@ -0,0 +1,3 @@
+#!/usr/bin/dh-exec
+usr/bin/go-5 usr/bin/go
+usr/bin/gofmt-5 usr/bin/gofmt
diff --git a/debian/golang-go.links b/debian/golang-go.links
new file mode 100755
index 0000000..9342dc1
--- /dev/null
+++ b/debian/golang-go.links
@@ -0,0 +1,4 @@
+#!/usr/bin/dh-exec
+usr/lib/go-${GOVER}/bin/go usr/bin/go
+usr/lib/go-${GOVER}/bin/gofmt usr/bin/gofmt
+usr/lib/go-${GOVER} usr/lib/go
diff --git a/debian/golang-go.manpages b/debian/golang-go.manpages
new file mode 100644
index 0000000..85c5e00
--- /dev/null
+++ b/debian/golang-go.manpages
@@ -0,0 +1 @@
+man/*
diff --git a/debian/golang-go.preinst b/debian/golang-go.preinst
new file mode 100755
index 0000000..a804121
--- /dev/null
+++ b/debian/golang-go.preinst
@@ -0,0 +1,22 @@
+#!/bin/sh
+
+set -e
+
+case "$1" in
+ upgrade)
+ # When golang-go was not a dependency package, it used alternatives to
+ # manage /usr/bin/go, and unfortunately did not remove the alternative on
+ # prerm upgrade (just uninstall|deconfigure). So remove it here.
+ update-alternatives --remove go /usr/lib/go/bin/go
+ ;;
+ install)
+ ;;
+ *)
+ echo "preinst called with unknown argument \`$1'" >&2
+ exit 0
+ ;;
+esac
+
+#DEBHELPER#
+
+exit 0
diff --git a/debian/golang-src.links b/debian/golang-src.links
new file mode 100755
index 0000000..16fbbcc
--- /dev/null
+++ b/debian/golang-src.links
@@ -0,0 +1,2 @@
+#!/usr/bin/dh-exec
+usr/share/go-${GOVER} usr/share/go
diff --git a/debian/helpers/getgoarches.pl b/debian/helpers/getgoarches.pl
new file mode 100755
index 0000000..6c7ad5d
--- /dev/null
+++ b/debian/helpers/getgoarches.pl
@@ -0,0 +1,14 @@
+#!/usr/bin/perl
+
+# Extract list of golang architectures by looking at control file.
+
+package main;
+
+use warnings;
+use strict;
+
+use Dpkg::Control::Info;
+
+my $control = Dpkg::Control::Info->new();
+my $p = $control->get_pkg_by_name("golang-go");
+printf("%s\n", $p->{Architecture});
diff --git a/debian/helpers/getver.pl b/debian/helpers/getver.pl
new file mode 100755
index 0000000..ee45ed8
--- /dev/null
+++ b/debian/helpers/getver.pl
@@ -0,0 +1,15 @@
+#!/usr/bin/perl
+
+# Extract upstream version from version in changelog.
+
+package main;
+
+use warnings;
+use strict;
+
+use Dpkg::Version;
+
+my $v = Dpkg::Version->new(`dpkg-parsechangelog -SVersion`)->version();
+$v =~ /^([0-9]+\.[0-9]+).*/;
+printf("%s\n", $1);
+
diff --git a/debian/rules b/debian/rules
new file mode 100755
index 0000000..689d8e7
--- /dev/null
+++ b/debian/rules
@@ -0,0 +1,26 @@
+#!/usr/bin/make -f
+# -*- makefile -*-
+
+export GOVER := $(shell debian/helpers/getver.pl)
+golang_archs = $(shell debian/helpers/getgoarches.pl)
+
+IS_GOLANG_ARCH := true
+ifeq (,$(filter $(DEB_HOST_ARCH),$(golang_archs)))
+ IS_GOLANG_ARCH := false
+endif
+
+%:
+ dh $@
+
+override_dh_clean:
+ dh_clean
+ rm -f debian/golang-any.links
+
+override_dh_prep:
+ dh_prep
+ifeq (false, $(IS_GOLANG_ARCH))
+ cp debian/golang-any.links.gccgo debian/golang-any.links
+endif
+
+override_dh_gencontrol:
+ dh_gencontrol -- -Vgolang:GOVER=$(GOVER)
diff --git a/debian/source/format b/debian/source/format
new file mode 100644
index 0000000..9f67427
--- /dev/null
+++ b/debian/source/format
@@ -0,0 +1 @@
+3.0 (native)
\ No newline at end of file
diff --git a/man/go-build.1 b/man/go-build.1
new file mode 100644
index 0000000..6e1794c
--- /dev/null
+++ b/man/go-build.1
@@ -0,0 +1,80 @@
+.\" Hey, EMACS: -*- nroff -*-
+.TH GO-BUILD 1 "2012-05-13"
+.\" Please adjust this date whenever revising the manpage.
+.SH NAME
+go \- tool for managing Go source code
+.SH SYNOPSIS
+.B go build
+.RB [\|\-o
+.IR output \|]
+.RB [
+.IR "build flags"
+.RB ]
+.RB [
+.IR packages
+.RB ]
+.SH DESCRIPTION
+Build compiles the packages named by the import paths,
+along with their dependencies, but it does not install the results.
+
+If the arguments are a list of .go files, build treats them as a list
+of source files specifying a single package.
+
+When the command line specifies a single main package,
+build writes the resulting executable to output.
+Otherwise build compiles the packages but discards the results,
+serving only as a check that the packages can be built.
+
+The \-o flag specifies the output file name. If not specified, the
+name is packagename.a (for a non-main package) or the base
+name of the first source file (for a main package).
+.SH OPTIONS
+The build flags are shared by the build, install, run, and test commands:
+.TP
+.B \-a
+force rebuilding of packages that are already up-to-date.
+.TP
+.B \-n
+print the commands but do not run them.
+.TP
+.B \-p n
+the number of builds that can be run in parallel. The default is the number of CPUs available.
+.TP
+.B \-v
+print the names of packages as they are compiled.
+.TP
+.B \-work
+print the name of the temporary work directory and do not delete it when exiting.
+.TP
+.B \-x
+print the commands.
+.TP
+.B \-compiler name
+name of compiler to use, as in runtime.Compiler (gccgo or gc)
+.TP
+.B \-gccgoflags 'arg list'
+arguments to pass on each gccgo compiler/linker invocation
+.TP
+.B \-gcflags 'arg list'
+arguments to pass on each 5g, 6g, or 8g compiler invocation
+.TP
+.B \-ldflags 'flag list'
+arguments to pass on each 5l, 6l, or 8l linker invocation
+.TP
+.B \-tags 'tag list'
+a list of build tags to consider satisfied during the build.
+See the documentation for the go/build package for
+more information about build tags.
+.P
+For more about specifying packages, see \fBgo-packages\fP(7).
+.P
+For more about where packages and binaries are installed, see \fBgo-gopath\fP(1).
+
+.SH SEE ALSO
+.BR go-install (1),
+.BR go-get (1),
+.BR go-clean (1).
+.SH AUTHOR
+.PP
+This manual page was written by Michael Stapelberg <stapelberg at debian.org>,
+for the Debian project (and may be used by others).
diff --git a/man/go-clean.1 b/man/go-clean.1
new file mode 100644
index 0000000..bff689e
--- /dev/null
+++ b/man/go-clean.1
@@ -0,0 +1,82 @@
+.\" Hey, EMACS: -*- nroff -*-
+.TH GO-CLEAN 1 "2012-05-13"
+.\" Please adjust this date whenever revising the manpage.
+.SH NAME
+go \- tool for managing Go source code
+.SH SYNOPSIS
+.B go clean
+.RB [\|\-i\|]
+.RB [\|\-r\|]
+.RB [\|\-n\|]
+.RB [\|\-x\|]
+.RB [
+.IR packages
+.RB ]
+.SH 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:
+
+.TP
+.B _obj/
+old object directory, left from Makefiles
+.TP
+.B _test/
+old test directory, left from Makefiles
+.TP
+.B _testmain.go
+old gotest file, left from Makefiles
+.TP
+.B test.out
+old test log, left from Makefiles
+.TP
+.B build.out
+old test log, left from Makefiles
+.TP
+.B *.[568ao]
+object files, left from Makefiles
+
+.TP
+.B DIR(.exe)
+from go build
+.TP
+.B DIR.test(.exe)
+from go test \-c
+.TP
+.B MAINFILE(.exe)
+from go build MAINFILE.go
+.P
+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.
+.SH OPTIONS
+.TP
+.B \-i
+The \-i flag causes clean to remove the corresponding installed
+archive or binary (what 'go install' would create).
+
+.TP
+.B \-n
+The \-n flag causes clean to print the remove commands it would execute,
+but not run them.
+
+.TP
+.B \-r
+The \-r flag causes clean to be applied recursively to all the
+dependencies of the packages named by the import paths.
+
+.TP
+.B \-x
+The \-x flag causes clean to print remove commands as it executes them.
+.P
+For more about specifying packages, see \fBgo-packages\fP(7).
+
+.SH AUTHOR
+.PP
+This manual page was written by Michael Stapelberg <stapelberg at debian.org>,
+for the Debian project (and may be used by others).
diff --git a/man/go-env.1 b/man/go-env.1
new file mode 100644
index 0000000..48a506d
--- /dev/null
+++ b/man/go-env.1
@@ -0,0 +1,21 @@
+.\" Hey, EMACS: -*- nroff -*-
+.TH GO-ENV 1 "2012-05-13"
+.\" Please adjust this date whenever revising the manpage.
+.SH NAME
+go \- tool for managing Go source code
+.SH SYNOPSIS
+.B go env
+.RB [
+.IR "var ..."
+.RB ]
+.SH DESCRIPTION
+Env prints Go environment information.
+
+By default env prints information as a shell script
+(on Windows, a batch file). If one or more variable
+names is given as arguments, env prints the value of
+each named variable on its own line.
+.SH AUTHOR
+.PP
+This manual page was written by Michael Stapelberg <stapelberg at debian.org>,
+for the Debian project (and may be used by others).
diff --git a/man/go-fix.1 b/man/go-fix.1
new file mode 100644
index 0000000..ed36888
--- /dev/null
+++ b/man/go-fix.1
@@ -0,0 +1,25 @@
+.\" Hey, EMACS: -*- nroff -*-
+.TH GO-FIX 1 "2012-05-13"
+.\" Please adjust this date whenever revising the manpage.
+.SH NAME
+go \- tool for managing Go source code
+.SH SYNOPSIS
+.B go fix
+.RB [
+.IR packages
+.RB ]
+.SH DESCRIPTION
+Fix runs the Go fix command on the packages named by the import paths.
+.P
+For more about fix, see 'godoc fix'.
+.P
+For more about specifying packages, see \fBgo-packages\fP(7).
+.P
+To run fix with specific options, run 'go tool fix'.
+.SH SEE ALSO
+.BR go-fmt (1),
+.BR go-vet (1).
+.SH AUTHOR
+.PP
+This manual page was written by Michael Stapelberg <stapelberg at debian.org>,
+for the Debian project (and may be used by others).
diff --git a/man/go-fmt.1 b/man/go-fmt.1
new file mode 100644
index 0000000..fc555b8
--- /dev/null
+++ b/man/go-fmt.1
@@ -0,0 +1,37 @@
+.\" Hey, EMACS: -*- nroff -*-
+.TH GO-FMT 1 "2012-06-15"
+.\" Please adjust this date whenever revising the manpage.
+.SH NAME
+go \- tool for managing Go source code
+.SH SYNOPSIS
+.B go fmt
+.RB [\|\-n\|]
+.RB [\|\-x\|]
+.RB [
+.IR packages
+.RB ]
+.SH DESCRIPTION
+Fmt runs the command 'gofmt \-l \-w' on the packages named
+by the import paths. It prints the names of the files that are modified.
+.P
+For more about gofmt, see 'godoc gofmt'.
+.P
+For more about specifying packages, see \fBgo-packages\fP(7).
+.P
+To run gofmt with specific options, run gofmt itself.
+.SH OPTIONS
+.TP
+.B \-n
+The \-n flag causes tool to print the command that would be
+executed but not execute it.
+.TP
+.B \-x
+The \-x flag causes clean to print remove commands as it executes them.
+.SH SEE ALSO
+.BR go-doc (1),
+.BR go-fix (1),
+.BR go-vet (1).
+.SH AUTHOR
+.PP
+This manual page was written by Michael Stapelberg <stapelberg at debian.org>,
+for the Debian project (and may be used by others).
diff --git a/man/go-get.1 b/man/go-get.1
new file mode 100644
index 0000000..8f09ed1
--- /dev/null
+++ b/man/go-get.1
@@ -0,0 +1,59 @@
+.\" Hey, EMACS: -*- nroff -*-
+.TH GO-GET 1 "2012-06-15"
+.\" Please adjust this date whenever revising the manpage.
+.SH NAME
+go \- tool for managing Go source code
+.SH SYNOPSIS
+.B go get
+.RB [\|\-a\|]
+.RB [\|\-d\|]
+.RB [\|\-fix\|]
+.RB [\|\-n\|]
+.RB [\|\-p
+.IR n \|]
+.RB [\|\-u\|]
+.RB [\|\-v\|]
+.RB [\|\-x\|]
+.RB [
+.IR packages
+.RB ]
+.SH DESCRIPTION
+Get downloads and installs the packages named by the import paths,
+along with their dependencies.
+
+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 most recent version
+of the package.
+
+.SH OPTIONS
+.TP
+.B \-a, \-n, \-v, \-x, \-p
+The \-a, \-n, \-v, \-x, and \-p flags have the same meaning as in 'go build'
+and 'go install'. See \fBgo-build\fP(1).
+.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 \-fix
+The \-fix flag instructs get to run the fix tool on the downloaded packages
+before resolving dependencies or building the code.
+.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.
+.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
+.PP
+This manual page was written by Michael Stapelberg <stapelberg at debian.org>,
+for the Debian project (and may be used by others).
diff --git a/man/go-install.1 b/man/go-install.1
new file mode 100644
index 0000000..9e53bb2
--- /dev/null
+++ b/man/go-install.1
@@ -0,0 +1,28 @@
+.\" Hey, EMACS: -*- nroff -*-
+.TH GO-INSTALL 1 "2012-05-13"
+.\" Please adjust this date whenever revising the manpage.
+.SH NAME
+go \- tool for managing Go source code
+.SH SYNOPSIS
+.B go install
+.RB [
+.IR "build flags"
+.RB ]
+.RB [
+.IR packages
+.RB ]
+.SH DESCRIPTION
+Install compiles and installs the packages named by the import paths,
+along with their dependencies.
+.P
+For more about the build flags, see \fBgo-build\fP(1).
+.P
+For more about specifying packages, see \fBgo-packages\fP(7).
+.SH SEE ALSO
+.BR go-build (1),
+.BR go-get (1),
+.BR go-clean (1).
+.SH AUTHOR
+.PP
+This manual page was written by Michael Stapelberg <stapelberg at debian.org>,
+for the Debian project (and may be used by others).
diff --git a/man/go-list.1 b/man/go-list.1
new file mode 100644
index 0000000..b97c250
--- /dev/null
+++ b/man/go-list.1
@@ -0,0 +1,104 @@
+.\" Hey, EMACS: -*- nroff -*-
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+.TH GO-LIST 1 "2012-05-13"
+.\" Please adjust this date whenever revising the manpage.
+.SH NAME
+go \- tool for managing Go source code
+.SH SYNOPSIS
+.B go list
+.RB [\|\-e\|]
+.RB [\|\-f
+.IR format \|]
+.RB [\|\-json\|]
+.RB [
+.IR packages
+.RB ]
+.SH DESCRIPTION
+List lists the packages named by the import paths, one per line.
+
+The default output shows the package import path:
+
+.Vb 6
+\& code.google.com/p/google-api-go-client/books/v1
+\& code.google.com/p/goauth2/oauth
+\& code.google.com/p/sqlite
+.Ve
+
+.SH OPTIONS
+
+.TP
+.B \-f
+The \-f flag specifies an alternate format for the list,
+using the syntax of package template. The default output
+is equivalent to \-f '{{.ImportPath}}'. The struct
+being passed to the template is:
+
+.Vb 6
+\& type Package struct {
+\& Dir string // directory containing package sources
+\& ImportPath string // import path of package in dir
+\& Name string // package name
+\& Doc string // package documentation string
+\& Target string // install path
+\& Goroot bool // is this package in the Go root?
+\& Standard bool // is this package part of the standard Go library?
+\& Stale bool // would 'go install' do anything for this package?
+\& Root string // Go root or Go path dir containing this package
+\&
+\& // Source files
+\& GoFiles []string // .go source files (excluding CgoFiles, TestGoFiles, XTestGoFiles)
+\& CgoFiles []string // .go sources files that import "C"
+\& CFiles []string // .c source files
+\& HFiles []string // .h source files
+\& SFiles []string // .s source files
+\& SysoFiles []string // .syso object files to add to archive
+\&
+\& // Cgo directives
+\& CgoCFLAGS []string // cgo: flags for C compiler
+\& CgoLDFLAGS []string // cgo: flags for linker
+\& CgoPkgConfig []string // cgo: pkg-config names
+\&
+\& // Dependency information
+\& Imports []string // import paths used by this package
+\& Deps []string // all (recursively) imported dependencies
+\&
+\& // Error information
+\& Incomplete bool // this package or a dependency has an error
+\& Error *PackageError // error loading package
+\& DepsErrors []*PackageError // errors loading dependencies
+\&
+\& TestGoFiles []string // _test.go files in package
+\& TestImports []string // imports from TestGoFiles
+\& XTestGoFiles []string // _test.go files outside package
+\& XTestImports []string // imports from XTestGoFiles
+\& }
+.Ve
+.TP
+.B \-json
+The \-json flag causes the package data to be printed in JSON format
+instead of using the template format.
+.TP
+.B \-e
+The \-e flag changes the handling of erroneous packages, those that
+cannot be found or are malformed. By default, the list command
+prints an error to standard error for each erroneous package and
+omits the packages from consideration during the usual printing.
+With the \-e flag, the list command never prints errors to standard
+error and instead processes the erroneous packages with the usual
+printing. Erroneous packages will have a non-empty ImportPath and
+a non-nil Error field; other information may or may not be missing
+(zeroed).
+.P
+For more about specifying packages, see \fBgo-packages\fP(7).
+.SH AUTHOR
+.PP
+This manual page was written by Michael Stapelberg <stapelberg at debian.org>,
+for the Debian project (and may be used by others).
diff --git a/man/go-packages.7 b/man/go-packages.7
new file mode 100644
index 0000000..ab6078d
--- /dev/null
+++ b/man/go-packages.7
@@ -0,0 +1,66 @@
+.\" Hey, EMACS: -*- nroff -*-
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+.TH GO-PACKAGES 7 "2012-05-13"
+.\" Please adjust this date whenever revising the manpage.
+.SH NAME
+go \- tool for managing Go source code
+.SH DESCRIPTION
+Many commands apply to a set of packages:
+
+.Vb 6
+\& go action [packages]
+.Ve
+
+Usually, [packages] is a list of import paths.
+
+An import path that is a rooted path or that begins with
+a . or .. element is interpreted as a file system path and
+denotes the package in that directory.
+
+Otherwise, the import path P denotes the package found in
+the directory DIR/src/P for some DIR listed in the GOPATH
+environment variable (see 'go help gopath').
+
+If no import paths are given, the action applies to the
+package in the current directory.
+
+The special import path "all" expands to all package directories
+found in all the GOPATH trees. For example, 'go list all'
+lists all the packages on the local system.
+
+The special import path "std" is like all but expands to just the
+packages in the standard Go library.
+
+An import path is a pattern if it includes one or more "..." wildcards,
+each of which can match any string, including the empty string and
+strings containing slashes. Such a pattern expands to all package
+directories found in the GOPATH trees with names matching the
+patterns. As a special case, x/... matches x as well as x's subdirectories.
+For example, net/... expands to net and packages in its subdirectories.
+
+An import path can also name a package to be downloaded from
+a remote repository. Run 'go help remote' for details.
+
+Every package in a program must have a unique import path.
+By convention, this is arranged by starting each path with a
+unique prefix that belongs to you. For example, paths used
+internally at Google all begin with 'google', and paths
+denoting remote repositories begin with the path to the code,
+such as 'code.google.com/p/project'.
+
+As a special case, if the package list is a list of .go files from a
+single directory, the command is applied to a single synthesized
+package made up of exactly those files, ignoring any build constraints
+in those files and ignoring any other files in the directory.
+.SH AUTHOR
+.PP
+This manual page was written by Michael Stapelberg <stapelberg at debian.org>,
+for the Debian project (and may be used by others).
diff --git a/man/go-path.7 b/man/go-path.7
new file mode 100644
index 0000000..13f696a
--- /dev/null
+++ b/man/go-path.7
@@ -0,0 +1,77 @@
+.\" Hey, EMACS: -*- nroff -*-
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+.TH GO-PATH 7 "2012-05-13"
+.\" Please adjust this date whenever revising the manpage.
+.SH NAME
+go \- tool for managing Go source code
+.SH 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 subdirectory 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:
+
+.Vb 4
+\& 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)
+.Ve
+
+Go searches each directory listed in GOPATH to find source code,
+but new packages are always downloaded into the first directory
+in the list.
+.SH AUTHOR
+.PP
+This manual page was written by Michael Stapelberg <stapelberg at debian.org>,
+for the Debian project (and may be used by others).
diff --git a/man/go-remote.7 b/man/go-remote.7
new file mode 100644
index 0000000..a1ca7a9
--- /dev/null
+++ b/man/go-remote.7
@@ -0,0 +1,166 @@
+.\" Hey, EMACS: -*- nroff -*-
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+.TH GO-REMOTE 7 "2012-05-13"
+.\" Please adjust this date whenever revising the manpage.
+.SH NAME
+go \- tool for managing Go source code
+.SH DESCRIPTION
+An import path (see \fBgo-importpath\fP(1)) denotes a package
+stored in the local file system. Certain import paths also
+describe how to obtain the source code for the package using
+a revision control system.
+
+A few common code hosting sites have special syntax:
+
+.TP
+.B BitBucket (Mercurial)
+.Vb 4
+\&import "bitbucket.org/user/project"
+\&import "bitbucket.org/user/project/sub/directory"
+.Ve
+
+.TP
+.B GitHub (Git)
+.Vb 4
+\&import "github.com/user/project"
+\&import "github.com/user/project/sub/directory"
+.Ve
+
+.TP
+.B Google Code Project Hosting (Git, Mercurial, Subversion)
+.Vb 4
+\&import "code.google.com/p/project"
+\&import "code.google.com/p/project/sub/directory"
+.Ve
+
+.Vb 4
+\&import "code.google.com/p/project.subrepository"
+\&import "code.google.com/p/project.subrepository/sub/directory"
+.Ve
+
+.TP
+.B Launchpad (Bazaar)
+
+.Vb 4
+\&import "launchpad.net/project"
+\&import "launchpad.net/project/series"
+\&import "launchpad.net/project/series/sub/directory"
+.Ve
+
+.Vb 4
+\&import "launchpad.net/~user/project/branch"
+\&import "launchpad.net/~user/project/branch/sub/directory"
+.Ve
+
+.P
+For code hosted on other servers, import paths may either be qualified
+with the version control type, or the go tool can dynamically fetch
+the import path over https/http and discover where the code resides
+from a <meta> tag in the HTML.
+
+To declare the code location, an import path of the form
+
+.Vb 6
+\& repository.vcs/path
+.Ve
+
+specifies the given repository, with or without the .vcs suffix,
+using the named version control system, and then the path inside
+that repository. The supported version control systems are:
+
+.TP
+.B Bazaar
+ .bzr
+.TP
+.B Git
+ .git
+.TP
+.B Mercurial
+ .hg
+.TP
+.B Subversion
+ .svn
+
+.P
+For example,
+
+.Vb 6
+\& import "example.org/user/foo.hg"
+.Ve
+
+denotes the root directory of the Mercurial repository at
+example.org/user/foo or foo.hg, and
+
+.Vb 6
+\& import "example.org/repo.git/foo/bar"
+.Ve
+
+denotes the foo/bar directory of the Git repository at
+example.com/repo or repo.git.
+
+When a version control system supports multiple protocols,
+each is tried in turn when downloading. For example, a Git
+download tries git://, then https://, then http://.
+
+If the import path is not a known code hosting site and also lacks a
+version control qualifier, the go tool attempts to fetch the import
+over https/http and looks for a <meta> tag in the document's HTML
+<head>.
+
+The meta tag has the form:
+
+.Vb 6
+\& <meta name="go-import" content="import-prefix vcs repo-root">
+.Ve
+
+The import-prefix is the import path corresponding to the repository
+root. It must be a prefix or an exact match of the package being
+fetched with "go get". If it's not an exact match, another http
+request is made at the prefix to verify the <meta> tags match.
+
+The vcs is one of "git", "hg", "svn", etc,
+
+The repo-root is the root of the version control system
+containing a scheme and not containing a .vcs qualifier.
+
+For example,
+
+.Vb 6
+\& import "example.org/pkg/foo"
+.Ve
+
+will result in the following request(s):
+
+.Vb 6
+\& https://example.org/pkg/foo?go-get=1 (preferred)
+\& http://example.org/pkg/foo?go-get=1 (fallback)
+.Ve
+
+If that page contains the meta tag
+
+.Vb 6
+\& <meta name="go-import" content="example.org git https://code.org/r/p/exproj">
+.Ve
+
+the go tool will verify that https://example.org/?go-get=1 contains the
+same meta tag and then git clone https://code.org/r/p/exproj into
+GOPATH/src/example.org.
+
+New downloaded packages are written to the first directory
+listed in the GOPATH environment variable (see \fBgo-path\fP(1)).
+
+The go command attempts to download the version of the
+package appropriate for the Go release being used.
+See \fBgo-install\fP(1) for more.
+.SH AUTHOR
+.PP
+This manual page was written by Michael Stapelberg <stapelberg at debian.org>,
+for the Debian project (and may be used by others).
diff --git a/man/go-run.1 b/man/go-run.1
new file mode 100644
index 0000000..a43f503
--- /dev/null
+++ b/man/go-run.1
@@ -0,0 +1,24 @@
+.\" Hey, EMACS: -*- nroff -*-
+.TH GO-RUN 1 "2012-05-13"
+.\" Please adjust this date whenever revising the manpage.
+.SH NAME
+go \- tool for managing Go source code
+.SH SYNOPSIS
+.B go run
+.RB [
+.IR "build flags"
+.RB ]
+.IR gofiles...
+.RB [
+.IR arguments...
+.RB ]
+.SH DESCRIPTION
+Run compiles and runs the main package comprising the named Go source files.
+.P
+For more about build flags, see \fBgo-build\fP(1).
+.SH SEE ALSO
+.BR go-build (1).
+.SH AUTHOR
+.PP
+This manual page was written by Michael Stapelberg <stapelberg at debian.org>,
+for the Debian project (and may be used by others).
diff --git a/man/go-test.1 b/man/go-test.1
new file mode 100644
index 0000000..3fdfa20
--- /dev/null
+++ b/man/go-test.1
@@ -0,0 +1,75 @@
+.\" Hey, EMACS: -*- nroff -*-
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+.TH GO-TEST 1 "2012-05-13"
+.\" Please adjust this date whenever revising the manpage.
+.SH NAME
+go \- tool for managing Go source code
+.SH SYNOPSIS
+.B go test
+.RB [\|\-c\|]
+.RB [\|\-i\|]
+.RB [
+.IR "build flags"
+.RB ]
+.RB [
+.IR packages
+.RB ]
+.RB [
+.IR "flags for test binary"
+.RB ]
+.SH DESCRIPTION
+"Go test" automates testing the packages named by the import paths.
+It prints a summary of the test results in the format:
+
+.Vb 6
+\& ok archive/tar 0.011s
+\& FAIL archive/zip 0.022s
+\& ok compress/gzip 0.033s
+\& ...
+.Ve
+
+followed by detailed output for each failed package.
+
+"Go test" recompiles each package along with any files with names matching
+the file pattern "*_test.go". These additional files can contain test functions,
+benchmark functions, and example functions. See \fBgo-testfunc\fP(7) for more.
+
+By default, go test needs no arguments. It compiles and tests the package
+with source in the current directory, including tests, and runs the tests.
+
+The package is built in a temporary directory so it does not interfere with the
+non-test installation.
+
+.SH OPTIONS
+
+In addition to the build flags, the flags handled by 'go test' itself are:
+
+.TP
+.B \-c
+Compile the test binary to pkg.test but do not run it.
+.TP
+.B \-i
+Install packages that are dependencies of the test.
+Do not run the test.
+.P
+The test binary also accepts flags that control execution of the test; these
+flags are also accessible by 'go test'. See \fBgo-testflag\fP(7) for details.
+.P
+For more about build flags, see \fBgo-build\fP(1).
+.P
+For more about specifying packages, see \fBgo-packages\fP(7).
+.SH SEE ALSO
+.BR go-build (1),
+.BR go-vet (1).
+.SH AUTHOR
+.PP
+This manual page was written by Michael Stapelberg <stapelberg at debian.org>,
+for the Debian project (and may be used by others).
diff --git a/man/go-testflag.7 b/man/go-testflag.7
new file mode 100644
index 0000000..f2b9f49
--- /dev/null
+++ b/man/go-testflag.7
@@ -0,0 +1,87 @@
+.\" Hey, EMACS: -*- nroff -*-
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+.TH GO-TESTFLAG 7 "2012-05-13"
+.\" Please adjust this date whenever revising the manpage.
+.SH NAME
+go \- tool for managing Go source code
+.SH DESCRIPTION
+The 'go test' command takes both flags that apply to 'go test' itself
+and flags that apply to the resulting test binary.
+
+The test binary, called pkg.test, where pkg is the name of the
+directory containing the package sources, has its own flags:
+
+.TP
+.B \-test.v
+Verbose output: log all tests as they are run.
+.TP
+.B \-test.run pattern
+Run only those tests and examples matching the regular expression.
+.TP
+.B \-test.bench pattern
+Run benchmarks matching the regular expression.
+By default, no benchmarks run.
+.TP
+.B \-test.cpuprofile cpu.out
+Write a CPU profile to the specified file before exiting.
+.TP
+.B \-test.memprofile mem.out
+Write a memory profile to the specified file when all tests
+are complete.
+.TP
+.B \-test.memprofilerate n
+Enable more precise (and expensive) memory profiles by setting
+runtime.MemProfileRate. See 'godoc runtime MemProfileRate'.
+To profile all memory allocations, use \-test.memprofilerate=1
+and set the environment variable GOGC=off to disable the
+garbage collector, provided the test can run in the available
+memory without garbage collection.
+.TP
+.B \-test.parallel n
+Allow parallel execution of test functions that call t.Parallel.
+The value of this flag is the maximum number of tests to run
+simultaneously; by default, it is set to the value of GOMAXPROCS.
+.TP
+.B \-test.short
+Tell long-running tests to shorten their run time.
+It is off by default but set during all.bash so that installing
+the Go tree can run a sanity check but not spend time running
+exhaustive tests.
+.TP
+.B \-test.timeout t
+If a test runs longer than t, panic.
+.TP
+.B \-test.benchtime n
+Run enough iterations of each benchmark to take n seconds.
+The default is 1 second.
+.TP
+.B \-test.cpu 1,2,4
+Specify a list of GOMAXPROCS values for which the tests or
+benchmarks should be executed. The default is the current value
+of GOMAXPROCS.
+.P
+For convenience, each of these \-test.X flags of the test binary is
+also available as the flag \-X in 'go test' itself. Flags not listed
+here are passed through unaltered. For instance, the command
+
+.Vb 6
+\& go test \-x \-v \-cpuprofile=prof.out \-dir=testdata \-update
+.Ve
+
+will compile the test binary and then run it as
+
+.Vb 6
+\& pkg.test \-test.v \-test.cpuprofile=prof.out \-dir=testdata \-update
+.Ve
+.SH AUTHOR
+.PP
+This manual page was written by Michael Stapelberg <stapelberg at debian.org>,
+for the Debian project (and may be used by others).
diff --git a/man/go-testfunc.7 b/man/go-testfunc.7
new file mode 100644
index 0000000..839fe15
--- /dev/null
+++ b/man/go-testfunc.7
@@ -0,0 +1,63 @@
+.\" Hey, EMACS: -*- nroff -*-
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+.TH GO-TESTFUNC 7 "2012-05-13"
+.\" Please adjust this date whenever revising the manpage.
+.SH NAME
+go \- tool for managing Go source code
+.SH DESCRIPTION
+The 'go test' command expects to find test, benchmark, and example functions
+in the "*_test.go" files corresponding to the package under test.
+
+A test function is one named TestXXX (where XXX is any alphanumeric string
+not starting with a lower case letter) and should have the signature,
+
+.Vb 6
+\& func TestXXX(t *testing.T) { ... }
+.Ve
+
+A benchmark function is one named BenchmarkXXX and should have the signature,
+
+.Vb 6
+\& func BenchmarkXXX(b *testing.B) { ... }
+.Ve
+
+An example function is similar to a test function but, instead of using *testing.T
+to report success or failure, prints output to os.Stdout and os.Stderr.
+That output is compared against the function's "Output:" comment, which
+must be the last comment in the function body (see example below). An
+example with no such comment, or with no text after "Output:" is compiled
+but not executed.
+
+Godoc displays the body of ExampleXXX to demonstrate the use
+of the function, constant, or variable XXX. An example of a method M with
+receiver type T or *T is named ExampleT_M. There may be multiple examples
+for a given function, constant, or variable, distinguished by a trailing _xxx,
+where xxx is a suffix not beginning with an upper case letter.
+
+Here is an example of an example:
+
+.Vb 6
+\& func ExamplePrintln() {
+\& Println("The output of\\nthis example.")
+\& // Output: The output of
+\& // this example.
+\& }
+.Ve
+
+The entire test file is presented as the example when it contains a single
+example function, at least one other function, type, variable, or constant
+declaration, and no test or benchmark functions.
+
+See the documentation of the testing package for more information.
+.SH AUTHOR
+.PP
+This manual page was written by Michael Stapelberg <stapelberg at debian.org>,
+for the Debian project (and may be used by others).
diff --git a/man/go-tool.1 b/man/go-tool.1
new file mode 100644
index 0000000..ebf8c26
--- /dev/null
+++ b/man/go-tool.1
@@ -0,0 +1,26 @@
+.\" Hey, EMACS: -*- nroff -*-
+.TH GO-TOOL 1 "2012-05-13"
+.\" Please adjust this date whenever revising the manpage.
+.SH NAME
+go \- tool for managing Go source code
+.SH SYNOPSIS
+.B go tool
+.RB [\|\-n\|]
+.IR command
+.RB [
+.IR args...
+.RB ]
+.SH DESCRIPTION
+Tool runs the go tool command identified by the arguments.
+With no arguments it prints the list of known tools.
+.SH OPTIONS
+.TP
+.B \-n
+The \-n flag causes tool to print the command that would be
+executed but not execute it.
+.P
+For more about each tool command, see 'go tool command \-h'.
+.SH AUTHOR
+.PP
+This manual page was written by Michael Stapelberg <stapelberg at debian.org>,
+for the Debian project (and may be used by others).
diff --git a/man/go-version.1 b/man/go-version.1
new file mode 100644
index 0000000..2c1ebe0
--- /dev/null
+++ b/man/go-version.1
@@ -0,0 +1,13 @@
+.\" Hey, EMACS: -*- nroff -*-
+.TH GO-VERSION 1 "2012-05-13"
+.\" Please adjust this date whenever revising the manpage.
+.SH NAME
+go \- tool for managing Go source code
+.SH SYNOPSIS
+.B go version
+.SH DESCRIPTION
+Version prints the Go version, as reported by runtime.Version.
+.SH AUTHOR
+.PP
+This manual page was written by Michael Stapelberg <stapelberg at debian.org>,
+for the Debian project (and may be used by others).
diff --git a/man/go-vet.1 b/man/go-vet.1
new file mode 100644
index 0000000..a165fd5
--- /dev/null
+++ b/man/go-vet.1
@@ -0,0 +1,35 @@
+.\" Hey, EMACS: -*- nroff -*-
+.TH GO-VET 1 "2012-06-15"
+.\" Please adjust this date whenever revising the manpage.
+.SH NAME
+go \- tool for managing Go source code
+.SH SYNOPSIS
+.B go vet
+.RB [\|\-n\|]
+.RB [\|\-x\|]
+.RB [
+.IR packages
+.RB ]
+.SH DESCRIPTION
+Vet runs the Go vet command on the packages named by the import paths.
+.P
+For more about vet, see 'godoc vet'.
+.P
+For more about specifying packages, see \fBgo-packages\fP(7).
+.P
+To run the vet tool with specific options, run 'go tool vet'.
+.SH OPTIONS
+.TP
+.B \-n
+The \-n flag causes tool to print the command that would be
+executed but not execute it.
+.TP
+.B \-x
+The \-x flag causes clean to print remove commands as it executes them.
+.SH SEE ALSO
+.BR go-fmt (1),
+.BR go-fix (1).
+.SH AUTHOR
+.PP
+This manual page was written by Michael Stapelberg <stapelberg at debian.org>,
+for the Debian project (and may be used by others).
diff --git a/man/go.1 b/man/go.1
new file mode 100644
index 0000000..27ae4df
--- /dev/null
+++ b/man/go.1
@@ -0,0 +1,66 @@
+.\" Hey, EMACS: -*- nroff -*-
+.TH GO 1 "2012-05-13"
+.\" Please adjust this date whenever revising the manpage.
+.SH NAME
+go \- tool for managing Go source code
+.SH SYNOPSIS
+.B go
+.RI command
+.RI [ arguments ]
+.SH DESCRIPTION
+The Go distribution includes a command, named \fBgo\fP, that automates the
+downloading, building, installation, and testing of Go packages and commands.
+.SH COMMANDS
+Each command is documented in its own manpage. For example, the \fBbuild\fP
+command is documented in \fBgo-build\fP(1). The commands are:
+.TP
+.B build
+compile packages and dependencies
+.TP
+.B clean
+remove object files
+.TP
+.B doc
+run godoc on package sources
+.TP
+.B env
+print Go environment information
+.TP
+.B fix
+run go tool fix on packages
+.TP
+.B fmt
+run gofmt on package sources
+.TP
+.B get
+download and install packages and dependencies
+.TP
+.B install
+compile and install packages and dependencies
+.TP
+.B list
+list packages
+.TP
+.B run
+compile and run Go program
+.TP
+.B test
+test packages
+.TP
+.B tool
+run specified go tool
+.TP
+.B version
+print Go version
+.TP
+.B vet
+run go tool vet on packages
+.SH EXAMPLES
+TODO
+.SH SEE ALSO
+.BR go-build (1),
+.BR go-clean (1).
+.SH AUTHOR
+.PP
+This manual page was written by Michael Stapelberg <stapelberg at debian.org>,
+for the Debian project (and may be used by others).
diff --git a/man/gofmt.1 b/man/gofmt.1
new file mode 100644
index 0000000..969a245
--- /dev/null
+++ b/man/gofmt.1
@@ -0,0 +1,108 @@
+.\" Hey, EMACS: -*- nroff -*-
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+.TH GOFMT 1 "2012-05-13"
+.\" Please adjust this date whenever revising the manpage.
+.SH NAME
+gofmt \- formats Go programs
+.SH SYNOPSIS
+.B gofmt
+.RI [ flags ]
+.RI [
+.IR "path ..."
+.RI ]
+.SH DESCRIPTION
+Without an explicit path, it processes the standard input. Given a file,
+it operates on that file; given a directory, it operates on all .go
+files in that directory, recursively. (Files starting with a period are
+ignored.) By default, gofmt prints the reformatted sources to standard
+output.
+
+.SH OPTIONS
+.TP
+.B \-d
+Do not print reformatted sources to standard output.
+If a file's formatting is different than gofmt's, print diffs
+to standard output.
+.TP
+.B \-e
+Print all (including spurious) errors.
+.TP
+.B \-l
+Do not print reformatted sources to standard output.
+If a file's formatting is different from gofmt's, print its name
+to standard output.
+.TP
+.B \-r rule
+Apply the rewrite rule to the source before reformatting.
+.TP
+.B \-s
+Try to simplify code (after applying the rewrite rule, if any).
+.TP
+.B \-w
+Do not print reformatted sources to standard output.
+If a file's formatting is different from gofmt's, overwrite it
+with gofmt's version.
+.P
+Formatting control flags:
+.TP
+.B \-comments=true
+Print comments; if false, all comments are elided from the output.
+.TP
+.B \-tabs=true
+Indent with tabs; if false, spaces are used instead.
+.TP
+.B \-tabwidth=8
+Tab width in spaces.
+.P
+
+The rewrite rule specified with the \-r flag must be a string of the
+form:
+
+.Vb 6
+\& pattern -> replacement
+.Ve
+
+Both pattern and replacement must be valid Go expressions. In the
+pattern, single-character lowercase identifiers serve as wildcards
+matching arbitrary sub-expressions; those expressions will be
+substituted for the same identifiers in the replacement.
+
+When gofmt reads from standard input, it accepts either a full Go
+program or a program fragment. A program fragment must be a
+syntactically valid declaration list, statement list, or expression.
+When formatting such a fragment, gofmt preserves leading indentation as
+well as leading and trailing spaces, so that individual sections of a Go
+program can be formatted by piping them through gofmt.
+.SH EXAMPLES
+To check files for unnecessary parentheses:
+
+.Vb 6
+\& gofmt \-r '(a) \-> a' \-l *.go
+.Ve
+
+To remove the parentheses:
+
+.Vb 6
+\& gofmt \-r '(a) \-> a' \-w *.go
+.Ve
+
+To convert the package tree from explicit slice upper bounds to implicit
+ones:
+
+.Vb 6
+\& gofmt \-r 'α[β:len(α)] \-> α[β:]' \-w $GOROOT/src/pkg
+.Ve
+.SH BUGS
+The implementation of \-r is a bit slow.
+.SH AUTHOR
+.PP
+This manual page was written by Michael Stapelberg <stapelberg at debian.org>,
+for the Debian project (and may be used by others).
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-golang/golang-defaults.git
More information about the pkg-golang-commits
mailing list