summaryrefslogtreecommitdiff
path: root/src/cmd/gopack/doc.go
diff options
context:
space:
mode:
authorRob Pike <r@golang.org>2009-11-03 22:36:31 -0800
committerRob Pike <r@golang.org>2009-11-03 22:36:31 -0800
commit670967ddbdcb15cd838b2cdb63781735b2fe3f7a (patch)
tree5fb7e8ac4ca9fc5fc85eef9b444d95357dc88ae6 /src/cmd/gopack/doc.go
parentca3cf3dd6309bf0b9b11ec59bdb12b443ed25c7e (diff)
downloadgolang-670967ddbdcb15cd838b2cdb63781735b2fe3f7a.tar.gz
document gopack.
change string in usage message. R=rsc http://go/go-review/1017023
Diffstat (limited to 'src/cmd/gopack/doc.go')
-rw-r--r--src/cmd/gopack/doc.go21
1 files changed, 21 insertions, 0 deletions
diff --git a/src/cmd/gopack/doc.go b/src/cmd/gopack/doc.go
new file mode 100644
index 000000000..241784dc3
--- /dev/null
+++ b/src/cmd/gopack/doc.go
@@ -0,0 +1,21 @@
+// Copyright 2009 The Go Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+/*
+
+The gopack program is a variant of the Plan 9 ar tool documented at
+
+ http://plan9.bell-labs.com/magic/man2html/1/ar
+
+It adds a special Go-specific section __.PKGDEF that collects all the
+Go type information from the files in the archive; that section is
+used by the compiler when importing the package during compilation.
+
+Usage: gopack [uvnbailo][mrxtdpq] archive files ...
+
+The new option 'g' causes gopack to maintain the __.PKGDEF section
+as files are added to the archive.
+
+*/
+package documentation