.! .! File: UNZIP_CLI.HELP .! .! Author: Hunter Goatley .! .! Date: 12 Jul 94 (orig. UNZIP.RNH, 23 Oct 91) .! .! Description: .! .! TPU-processable source file to produce VMS on-line help for .! portable UnZip. Adapted from UNZIP.RNH, originally based on .! UNZIP.MAN (now UNZIP.DOC). .! .! To build: .! $ EDIT /TPU/NOSECTION/NODISPLAY/COMMAND=CVTHELP.TPU UNZIP_CLI.HELP .! $ REN UNZIP_CLI.RNH UNZIP.RNH .! $ RUNOFF UNZIP.RNH .! $ LIBR /HELP/INSERT libr UNZIP .! .! Modification history: .! .! 02-001 Hunter Goatley 12-JUL-1994 16:59 .! Genesis. .! 02-002 Cave Newt 14-JUL-1994 11:36 .! Fixed /*TEXT options and added/removed various options. .! 02-003 Cave Newt 28-JUL-1994 08:54 .! Removed semicolons from comments and moved /ZIPINFO. .!
UNZIP UnZip is used to extract files compressed and packaged by Zip (see HELP ZIP for information on ZIP). For a brief help on Zip and Unzip, run each without specifying any parameters on the command line. UNZIP will list, test, or extract from a ZIP archive. ZIP archives are commonly found on MS-DOS systems; a VMS version of ZIP can also be found here. Archive member extraction is implied by the absence of the -c, -p, -t, -l, -v or -z options. All archive members are processed unless a filespec is provided to specify a subset of the archive members. UNZIP zipfile [file[,...]] [/qualifiers] .! Parameters zipfile File specification for the ZIP archive(s) with optional wildcards. UnZip will perform actions specified for every zipfile matching the specification. The default file specification is SYS$DISK:[].ZIP. Note that self-extracting ZIP files are supported; just specify the .EXE suffix yourself. file An optional comma-separated list of archive members to be processed; if no list is given, all archive members are processed. Expressions may be used to match multiple members. Expressions should be enclosed in double-quotes to prevent interpretation by DCL. Multiple filenames should be separated by blanks. Each file specification is similar to a Unix egrep expression and may contain: |* matches a sequence of 0 or more characters |? matches exactly 1 character |[...] matches any single character found inside the brackets; | ranges are specified by a beginning character, | a hyphen, and an ending character. If a '!' or '^' | immediately follows the left bracket, then any character | not in the given range is matched. /ZIPINFO /ZIPINFO Displays information about the Zip archive and the files contained therein. This function used to be provided by a separate ZipInfo program. The following qualifiers may be specified with /ZIPINFO: | /SHORT Short UNIX "ls -l" format (default) | /MEDIUM Medium UNIX "ls -l" format | /LONG Long UNIX "ls -l" format | /ONE_LINE Filenames only, one per line | /VERBOSE Verbose, multi-page format | /HEADER Print header lines | /TOTALS Print totals for files | /TIMES Print file times in sortable decimal format /AUTOTEXT /AUTOTEXT /NOAUTOTEXT Automatically extracts files marked as "text" (rather than "binary") in in standard VMS text file format. /BRIEF /BRIEF When used with /LIST, specifies that a brief listing of the archive's contents is to be displayed. A brief listing shows the length, date, time, and file name for the files in the archive. /CASE_INSENSITIVE /CASE_INSENSITIVE /NOCASE_INSENSITIVE Match filenames case-insensitively. (Good default option under VMS.) /COMMENT /COMMENT /NOCOMMENT Display the archive comment. /DIRECTORY /DIRECTORY=directory-spec Specifies the output directory where all the extracted files are to be placed. /EXCLUDE /EXCLUDE=file A comma-separated list of files to exclude when extracting files. If multiple files are specified, the list should be included in parentheses. /FRESHEN /FRESHEN /NOFRESHEN Freshen existing files; replace if newer. Does not cause any new files to be created. /FULL /FULL When used with /LIST, specifies that a full listing of the archive's contents is to be displayed. A full listing shows the length, compression method, compressed size, compression ratio, date, time, CRC value, and file name for the files in the archive. /JUNK /JUNK /NOJUNK Junk the stored paths (don't recreated the archive's directory structure. /LIST /LIST List the contents of the archive. /BRIEF and /FULL can be used to specify the amount of information displayed. The default is /BRIEF. /LOWERCASE /LOWERCASE /NOLOWERCASE Convert filenames from all-uppercase operating systems to lowercase. This option has no effect under VMS. /OVERWRITE /OVERWRITE /NOOVERWRITE Overwrite existing files when extracting. /PIPE /PIPE Extract files to SYS$OUTPUT with no informational messages. /QUIET /QUIET Perform operations quietly. /SUPER_QUIET can be specified to make it even quiet. /RESTORE /RESTORE /NORESTORE Restore file owner and protection settings. /SCREEN /SCREEN /NOSCREEN Extracts matching files to SYS$OUTPUT (the terminal). /SUPER_QUIET /SUPER_QUIET Perform operations super-quietly. /TEST /TEST /NOTEST Test archive files. /TEXT /TEXT /NOTEXT Extracts all files in standard VMS text file format. /UPDATE /UPDATE /NOUPDATE Update existing files; create new ones if needed. /VERSION /VERSION /NOVERSION Retain VMS file version numbers. Authors Info-ZIP; currently maintained by Greg Roelofs. VMS support maintained by Igor Mandrichenko and Hunter Goatley. Originally based on a program by Samuel H. Smith. VMS on-line help ported from UNZIP.DOC by Hunter Goatley. UNIX_Options The default action of UnZip is to extract all zipfile entries. The following options and modifiers can be provided: | -Z ZipInfo mode | -c extract files to SYS$OUTPUT (terminal) | -f freshen existing files (replace if newer); create none | -l list archive files (short format) | -p extract files to SYS$OUTPUT; no informational messages | -t test archive files | -u update existing files; create new ones if needed | -v list archive files (verbose format) | -z display only the archive comment | | MODIFIERS | -a auto-extract only text files in standard VMS text file format | -aa extract all files as text | -j junk paths (don't recreate archive's directory structure) | -n never overwrite existing files; don't prompt | -o OK to overwrite files without prompting | -q perform operations quietly (-qq => even quieter) | -C match filenames case-insensitively | -L convert filenames to lowercase if created under MS-DOS, VMS, etc. | -V retain (VMS) file version numbers | -X restore owner/protection info (may require privileges) Note that uppercase options such as -C, -L, -V, -X and -Z must be specified in quotes. For example: | $ unzip "-VX" -a zipfile .![this should probably be a separate section]: In addition, default options may be specified via the UNZIP_OPTS logical. For example, the following will cause UnZip to match filenames without regard to case, restore owner/protection information and perform all operations at quiet-level 1 by default: | $ define UNZIP_OPTS "-qCX" Note that the quotation marks here are required to preserve lowercase options (opposite of the command-line behavior). To negate a default option on the command line, add one or more minus signs before the option letter, in addition to the leading switch character `-': | $ unzip --ql zipfile or | $ unzip -l-q zipfile At present it is not possible to decrement an option below zero--that is, more than a few minuses have no effect. UNZIP_OPTS may be defined as a symbol rather than a logical, but if both are defined, the logical is used.