summaryrefslogtreecommitdiff
path: root/src/cmd/pack/doc.go
blob: 8b17f3ca222d707c099e33833e1c23921ee38733 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
// 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.

/*

Pack is a variant of the Plan 9 ar tool.  The original is 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:
	go tool pack [uvnbailogS][mrxtdpq][P prefix] archive files ...

The new option 'g' causes pack to maintain the __.PKGDEF section
as files are added to the archive.

The new option 'S' forces pack to mark the archive as safe.

The new option 'P' causes pack to remove the given prefix
from file names in the line number information in object files
that are already stored in or added to the archive.
*/
package documentation