github.com/ader1990/go@v0.0.0-20140630135419-8c24447fa791/src/cmd/pack/doc.go (about)

     1  // Copyright 2014 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  /*
     6  
     7  Pack is a simple version of the traditional Unix ar tool.
     8  It implements only the operations needed by Go.
     9  
    10  Usage:
    11  	go tool pack op file.a [name...]
    12  
    13  Pack applies the operation to the archive, using the names as arguments to the operation.
    14  
    15  The operation op is given by one of these letters:
    16  
    17  	c	append files (from the file system) to a new archive
    18  	p	print files from the archive
    19  	r	append files (from the file system) to the archive
    20  	t	list files from the archive
    21  	x	extract files from the archive
    22  
    23  For the p, t, and x commands, listing no names on the command line
    24  causes the operation to apply to all files in the archive.
    25  
    26  In contrast to Unix ar, the r operation always appends to the archive,
    27  even if a file with the given name already exists in the archive. In this way
    28  pack's r operation is more like Unix ar's rq operation.
    29  
    30  Adding the letter v to an operation, as in pv or rv, enables verbose operation:
    31  For the c and r commands, names are printed as files are added.
    32  For the p command, each file is prefixed by the name on a line by itself.
    33  For the t command, the listing includes additional file metadata.
    34  For the x command, names are printed as files are extracted.
    35  
    36  */
    37  package main