Return to unzip.1 CVS log

Up to [MW Coherent from dump] / coherent / b / bin / unzip

Annotation of coherent/b/bin/unzip/unzip.1, revision 1.1

1.1     ! root        1: .TH UNZIP 1 "22 Aug 92 (v5.0)"
        !             2: .SH NAME
        !             3: unzip \- list/test/extract from a ZIP archive file
        !             4: .SH SYNOPSIS
        !             5: \fBunzip\fP [ \-\fBcflptuvxz\fP[\fBajnoqUV\fP] ] \fIfile\fP[\fI.zip\fP] [\fIfilespec\fP\ ...]
        !             6: .SH ARGUMENTS
        !             7: .IP \fIfile\fP[\fI.zip\fP] \w'[\fIfilespec\fP]'u+2m
        !             8: Path of the ZIP archive.  The suffix
        !             9: ``\fI.zip\fP'' is applied if the \fIfile\fP specified does not exist.
        !            10: Note that self-extracting ZIP files are supported; just specify the
        !            11: ``\fI.exe\fP'' suffix yourself.
        !            12: .IP [\fIfilespec\fP]
        !            13: An optional list of archive members to be processed.
        !            14: Expressions may be used to match multiple members; be sure to quote
        !            15: expressions that contain characters interpreted by the operating
        !            16: system. See DESCRIPTION (below) for more details.
        !            17: .SH OPTIONS
        !            18: .PD 0
        !            19: .IP \-c \w'\-c'u+2m
        !            20: extract files to stdout/screen (``CRT'')
        !            21: .IP \-f
        !            22: freshen existing files (replace if newer); create none
        !            23: .IP \-l
        !            24: list archive files (short format)
        !            25: .IP \-p
        !            26: extract files to pipe; no informational messages
        !            27: .IP \-t
        !            28: test archive files
        !            29: .IP \-u
        !            30: update existing files; create new ones if needed
        !            31: .IP \-v
        !            32: list archive files (verbose format)
        !            33: .IP \-x
        !            34: extract files in archive (default)
        !            35: .IP \-z
        !            36: display only the archive comment
        !            37: .PD
        !            38: .SH MODIFIERS
        !            39: .PD 0
        !            40: .IP \-a \w'\-a'u+2m
        !            41: convert to MS-DOS textfile format (CR LF), Mac format (CR), Unix/VMS
        !            42: format (LF), OR from ASCII to EBCDIC, depending on your system (only
        !            43: use for TEXT files!)
        !            44: .IP \-j
        !            45: junk paths (don't recreate archive's directory structure)
        !            46: .IP \-n
        !            47: never overwrite existing files; don't prompt
        !            48: .IP \-o
        !            49: OK to overwrite files without prompting
        !            50: .IP \-q
        !            51: perform operations quietly (\-qq \(rh even quieter)
        !            52: .IP \-s
        !            53: [OS/2, MS-DOS] allow spaces in filenames (e.g., ``EA\ DATA.\ SF'')
        !            54: .IP \-U
        !            55: leave filenames uppercase if created under MS-DOS, VMS, etc.
        !            56: .IP \-V
        !            57: retain (VMS) file version numbers
        !            58: .IP \-X
        !            59: [VMS] restore owner/protection info (may require privileges)
        !            60: .PD
        !            61: .SH DESCRIPTION
        !            62: .I UnZip
        !            63: will list, test, or extract from a ZIP archive, commonly found on MSDOS
        !            64: systems.
        !            65: Archive member extraction is implied by the absence of the \-c, \-p,
        !            66: \-t, \-l, \-v or \-z options.  All archive members are processed unless a
        !            67: .I filespec
        !            68: is provided to specify a subset of the archive members.  The
        !            69: .I filespec
        !            70: is similar to an egrep expression, and may contain:
        !            71: .sp 1
        !            72: .ta \w'[...]'u+2m
        !            73: *      matches a sequence of 0 or more characters
        !            74: .br
        !            75: ?      matches exactly 1 character
        !            76: .br
        !            77: \\nnn  matches the character having octal code nnn
        !            78: .PD 0
        !            79: .IP [...] \w'[...]'u+2m
        !            80: matches any single character found inside the brackets; ranges
        !            81: are specified by a beginning character, a hyphen, and an ending
        !            82: character.  If an exclamation point or a carat (`!' or `^') follows
        !            83: the left bracket, then the range of characters matched is complemented
        !            84: with respect to the ASCII character set (that is, anything except the
        !            85: characters inside the brackets is considered a match).
        !            86: .PD
        !            87: .SH ENVIRONMENT OPTIONS
        !            88: \fIUnZip\fP's default behavior may be modified via options placed in
        !            89: an environment variable.  This can be done with any option, but it
        !            90: is probably most useful with the
        !            91: \-q, \-o, or \-n modifiers:  in order to make \fIUnZip\fP quieter by 
        !            92: default, or to make it always overwrite or never overwrite files as it
        !            93: extracts them.  For example, to
        !            94: make \fIUnZip\fP act as quietly as possible, only reporting errors, one would
        !            95: use one of the following commands:
        !            96: .ta \w'tabset'u +\w'UNZIP=-qq; export UNZIP'u+4m
        !            97: .PP
        !            98: .IP "\tsetenv UNZIP -qq\tUnix C shell"
        !            99: .br
        !           100: .IP "\tUNZIP=-qq; export UNZIP\tUnix Bourne shell"
        !           101: .PP
        !           102: .IP "\tset UNZIP=-qq\tOS/2 or MS-DOS"
        !           103: .PP
        !           104: .IP "\tdefine UNZIP_OPTS ""-qq""\tVMS (quotes for LOWERCASE)"
        !           105: .PP
        !           106: Environment options are, in effect, considered to be just like any other
        !           107: command-line options, except that they are effectively the first options
        !           108: on the command line.  To override
        !           109: an environment option, one may use the ``minus operator'' to remove it.  For
        !           110: instance, to override one of the quiet-flags in the example above, use the
        !           111: command
        !           112: .PP
        !           113: .IP "\t\fIunzip\fP \-\-q[other options] zipfile"
        !           114: .PP
        !           115: The first hyphen is the normal
        !           116: switch character, and the second is a minus sign, acting on the q option.
        !           117: Thus the effect here is to cancel a single quantum of quietness.  To cancel
        !           118: both quiet flags, two (or more) minuses may be used:
        !           119: .PP
        !           120: .IP "\t\fIunzip\fP \-x\-\-q zipfile"
        !           121: .PP
        !           122: or
        !           123: .PP
        !           124: .IP "\t\fIunzip\fP \-\-\-qx zipfile"
        !           125: .PP
        !           126: (the two are equivalent).  This may seem awkward
        !           127: or confusing, but it is reasonably intuitive:  just ignore the first
        !           128: hyphen and go from there.  It is also consistent with the behavior of Unix
        !           129: nice(1).
        !           130: .PD
        !           131: .SH EXAMPLES
        !           132: To use \fIUnZip\fP to extract all members of the archive letters.zip,
        !           133: creating any directories as necessary:
        !           134: .PP
        !           135: .IP "\t\fIunzip\fP letters"
        !           136: .PP
        !           137: To extract all members of letters.zip to the current directory:
        !           138: .PP
        !           139: .IP "\t\fIunzip\fP -j letters"
        !           140: .PP
        !           141: To test letters.zip, printing only a summary message indicating
        !           142: whether the archive is OK or not:
        !           143: .PP
        !           144: .IP "\t\fIunzip\fP -tq letters"
        !           145: .PP
        !           146: To extract to standard output all members of letters.zip whose names end
        !           147: in ``.tex'', converting to the local end-of-line convention and piping the
        !           148: output into more(1):
        !           149: .PP
        !           150: .IP "\t\fIunzip\fP \-ca letters \e*.tex | more"
        !           151: .PP
        !           152: (The backslash before the asterisk is only required if the shell expands
        !           153: wildcards, as in Unix; double quotes could have been used instead, as in
        !           154: the source example below.)\ \ To extract the binary file paper1.dvi to 
        !           155: standard output and pipe it to a printing program:
        !           156: .PP
        !           157: .IP "\t\fIunzip\fP \-p articles paper1.dvi | dvips"
        !           158: .PP
        !           159: To extract all FORTRAN and C source files--*.f, *.c, *.h, Makefile (the
        !           160: double quotes are necessary only in Unix and only if globbing is turned on):
        !           161: .PP
        !           162: .IP "\t\fIunzip\fP source.zip ""*.[fch]"" Makefile"
        !           163: .PP
        !           164: To extract only newer versions of the files already in the current directory,
        !           165: without querying (NOTE:  be careful of unzipping in one timezone a zipfile 
        !           166: created in another--ZIP archives contain no timezone information, and a 
        !           167: ``newer'' file from an eastern timezone may, in fact, be older):
        !           168: .PP
        !           169: .IP "\t\fIunzip\fP \-fo sources"
        !           170: .PP
        !           171: To extract newer versions of the files already in the current directory and
        !           172: to create any files not already there (same caveat as previous example):
        !           173: .PP
        !           174: .IP "\t\fIunzip\fP \-uo sources"
        !           175: .PP
        !           176: .PP
        !           177: In the last five examples, assume that UNZIP or UNZIP_OPTS is set to -q.
        !           178: To do a singly quiet listing:
        !           179: .PP
        !           180: .IP "\t\fIunzip\fP \-\fIl\fP \fIfile\fP"
        !           181: .PP
        !           182: To do a doubly quiet listing:
        !           183: .PP
        !           184: .IP "\t\fIunzip\fP \-\fIql\fP \fIfile\fP"
        !           185: .PP
        !           186: To do a standard listing:
        !           187: .PP
        !           188: .IP "\t\fIunzip\fP \-\-\fIql\fP \fIfile\fP"
        !           189: .PP
        !           190: or
        !           191: .PP
        !           192: .IP "\t\fIunzip\fP \-\fIl\fP\-\fIq\fP \fIfile\fP"
        !           193: .PP
        !           194: or
        !           195: .PP
        !           196: .IP "\t\fIunzip\fP \-\fIl\fP\-\-\fIq\fP \fIfile\fP"
        !           197: .PP
        !           198: (extra minuses don't hurt).
        !           199: .PD
        !           200: .SH TIPS
        !           201: The current maintainer, being a lazy sort, finds it very useful to define
        !           202: an alias ``tt'' for ``unzip -tq''.  One may then simply type ``tt zipfile''
        !           203: to test the archive, something which one ought make a habit of doing.
        !           204: With luck \fIUnZip\fP will report ``No errors detected in zipfile.zip,''
        !           205: after which one may breathe a sigh of relief.
        !           206: .PD
        !           207: .SH SEE ALSO
        !           208: funzip(1), zip(1), zipcloak(1), zipinfo(1), zipnote(1), zipsplit(1)
        !           209: .PD
        !           210: .SH AUTHORS
        !           211: Samuel H. Smith, Carl Mascott, David P. Kirschbaum, Greg R. Roelofs, Mark
        !           212: Adler, Kai Uwe Rommel, Igor Mandrichenko, Johnny Lee, Jean-loup Gailly; Glenn
        !           213: Andrews, Joel Aycock, Allan Bjorklund, James Birdsall, Wim Bonner, John Cowan,
        !           214: Frank da Cruz, Bill Davidsen, Arjan de Vet, James Dugal, Jim Dumser, Mark
        !           215: Edwards, David Feinleib, Mike Freeman, Hunter Goatley, Robert Heath, Dave
        !           216: Heiland, Larry Jones, Kjetil J(o)rgenson, Bob Kemp, J. Kercheval, Alvin Koh,
        !           217: Bo Kullmar, Johnny Lee, Warner Losh, Fulvio Marino, Gene McManus, Joe Meadows,
        !           218: Mike O'Carroll, Humberto Ortiz-Zuazaga, Piet W. Plomp, Antonio Querubin Jr.,
        !           219: Steve Salisbury, Georg Sassen, Jon Saxton, Hugh Schmidt, Martin Schulz, Charles
        !           220: Scripter, Chris Seaman, Richard Seay, Alex Sergejew, Cliff Stanford, Onno van
        !           221: der Linden, Jim Van Zandt, Antoine Verheijen, Paul Wells.
        !           222: .PD
        !           223: .SH VERSIONS
        !           224: .ta \w'vx.x\ \ 'u +\w'fall 1989\ \ 'u
        !           225: .PD 0
        !           226: .IP "v1.2\t15 Mar 89" \w'\t\t'u
        !           227: Samuel H. Smith
        !           228: .IP "v2.0\t\ 9 Sep 89"
        !           229: Samuel H. Smith
        !           230: .IP "v2.x\tfall 1989"
        !           231: many Usenet contributors
        !           232: .IP "v3.0\t\ 1 May 90"
        !           233: Info-ZIP (DPK, consolidator)
        !           234: .IP "v3.1\t15 Aug 90"
        !           235: Info-ZIP (DPK, consolidator)
        !           236: .IP "v4.0\t\ 1 Dec 90"
        !           237: Info-ZIP (GRR, maintainer)
        !           238: .IP "v4.1\t12 May 91"
        !           239: Info-ZIP
        !           240: .IP "v4.2\t20 Mar 92"
        !           241: Info-ZIP (zip-bugs subgroup; GRR, maint.)
        !           242: .IP "v5.0\t21 Aug 92"
        !           243: Info-ZIP (zip-bugs subgroup; GRR, maint.)
        !           244: .PD

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.