github.com/rohankumardubey/syslog-redirector-golang@v0.0.0-20140320174030-4859f03d829a/src/cmd/pack/doc.go (about)

     1  // Copyright 2009 The Go Authors. All rights reserved.
     2  // Use of this source code is governed by a BSD-style
     3  // license that can be found in the LICENSE file.
     4  
     5  // +build ignore
     6  
     7  /*
     8  
     9  Pack is a variant of the Plan 9 ar tool.  The original is documented at
    10  
    11  	http://plan9.bell-labs.com/magic/man2html/1/ar
    12  
    13  It adds a special Go-specific section __.PKGDEF that collects all the
    14  Go type information from the files in the archive; that section is
    15  used by the compiler when importing the package during compilation.
    16  
    17  Usage:
    18  	go tool pack [uvnbailogS][mrxtdpq][P prefix] archive files ...
    19  
    20  The new option 'g' causes pack to maintain the __.PKGDEF section
    21  as files are added to the archive.
    22  
    23  The new option 'S' forces pack to mark the archive as safe.
    24  
    25  The new option 'P' causes pack to remove the given prefix
    26  from file names in the line number information in object files
    27  that are already stored in or added to the archive.
    28  */
    29  package main