.!
.!  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.
.!
.noflags;.lm3;.rm70
.!------------------------------------------------------
.indent-3
1 UNZIP
.br
UnZip is used to extract files compressed and packaged by Zip (see HELP ZIP
for information on ZIP).
.sk
For a brief help on Zip and Unzip, run each without specifying any
parameters on the command line.
.sk
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.
.sk
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.
.sk;.indent2
UNZIP zipfile [file[,...]] [/qualifiers]
.sk
.!
.!------------------------------------------------------
.indent-3
2 Parameters
.br
.indent-2
zipfile
.sk
.lm+3
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.
.sk
Note that self-extracting ZIP files are supported; just specify the .EXE
suffix yourself.
.lm-3
.sk
.indent-2
file
.sk
.lm+3
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:
.sk
.lm+4;.literal
*       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.
.end literal;.lm-4
.lm-3
.sk
.indent-3;2 Qualifiers
.!------------------------------------------------------
.sk;.indent-3
/ZIPINFO
.sk
/ZIPINFO
.sk
Displays information about the Zip archive and the files contained therein.
This function used to be provided by a separate ZipInfo program.
.sk
The following qualifiers may be specified with /ZIPINFO:
.sk
.lm+4;.literal
  /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
.end literal;.lm-4
.!------------------------------------------------------
.sk;.indent-3
/AUTOTEXT
.sk
/AUTOTEXT
/NOAUTOTEXT
.sk
Automatically extracts files marked as "text" (rather than "binary") in
in standard VMS text file format.
.!------------------------------------------------------
.sk;.indent-3
/BRIEF
.sk
/BRIEF
.sk
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.
.!------------------------------------------------------
.sk;.indent-3
/CASE_INSENSITIVE
.sk
/CASE_INSENSITIVE
/NOCASE_INSENSITIVE
.sk
Match filenames case-insensitively.  (Good default option under VMS.)
.!------------------------------------------------------
.sk;.indent-3
/COMMENT
.sk
/COMMENT
/NOCOMMENT
.sk
Display the archive comment.
.!------------------------------------------------------
.sk;.indent-3
/DIRECTORY
.sk
/DIRECTORY=directory-spec
.sk
Specifies the output directory where all the extracted files are to be
placed.
.!------------------------------------------------------
.sk;.indent-3
/EXCLUDE
.sk
/EXCLUDE=file
.sk
A comma-separated list of files to exclude when extracting files.
If multiple files are specified, the list should be included in
parentheses.

.!------------------------------------------------------
.sk;.indent-3
/FRESHEN
.sk
/FRESHEN
/NOFRESHEN
.sk
Freshen existing files; replace if newer.  Does not cause any new files to
be created.
.!------------------------------------------------------
.sk;.indent-3
/FULL
.sk
/FULL
.sk
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.
.!------------------------------------------------------
.sk;.indent-3
/JUNK
.sk
/JUNK
/NOJUNK
.sk
Junk the stored paths (don't recreated the archive's directory
structure.
.!------------------------------------------------------
.sk;.indent-3
/LIST
.sk
/LIST
.sk
List the contents of the archive.  /BRIEF and /FULL can be used to
specify the amount of information displayed.  The default is /BRIEF.
.!------------------------------------------------------
.sk;.indent-3
/LOWERCASE
.sk
/LOWERCASE
/NOLOWERCASE
.sk
Convert filenames from all-uppercase operating systems to lowercase.  This 
option has no effect under VMS.
.!------------------------------------------------------
.sk;.indent-3
/OVERWRITE
.sk
/OVERWRITE
/NOOVERWRITE
.sk
Overwrite existing files when extracting.
.!------------------------------------------------------
.sk;.indent-3
/PIPE
.sk
/PIPE
.sk
Extract files to SYS$OUTPUT with no informational messages.
.!------------------------------------------------------
.sk;.indent-3
/QUIET
.sk
/QUIET
.sk
Perform operations quietly.  /SUPER_QUIET can be specified to make it
even quiet.
.!------------------------------------------------------
.sk;.indent-3
/RESTORE
.sk
/RESTORE
/NORESTORE
.sk
Restore file owner and protection settings.
.!------------------------------------------------------
.sk;.indent-3
/SCREEN
.sk
/SCREEN
/NOSCREEN
.sk
Extracts matching files to SYS$OUTPUT (the terminal).
.!------------------------------------------------------
.sk;.indent-3
/SUPER_QUIET
.sk
/SUPER_QUIET
.sk
Perform operations super-quietly.
.!------------------------------------------------------
.sk;.indent-3
/TEST
.sk
/TEST
/NOTEST
.sk
Test archive files.
.!------------------------------------------------------
.sk;.indent-3
/TEXT
.sk
/TEXT
/NOTEXT
.sk
Extracts all files in standard VMS text file format.
.!------------------------------------------------------
.sk;.indent-3
/UPDATE
.sk
/UPDATE
/NOUPDATE
.sk
Update existing files; create new ones if needed.
.!------------------------------------------------------
.sk;.indent-3
/VERSION
.sk
/VERSION
/NOVERSION
.sk
Retain VMS file version numbers.

.!------------------------------------------------------
.indent-3
2 Authors
.br
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.
.sk
VMS on-line help ported from UNZIP.DOC by Hunter Goatley.

.!------------------------------------------------------
.indent-3
2 UNIX_Options
.br
The default action of UnZip is to extract all zipfile entries.  The following
options and modifiers can be provided:
.sk
.lm+4;.literal
   -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)
.end literal;.lm-4
.sk
Note that uppercase options such as -C, -L, -V, -X and -Z must be specified 
in quotes.  For example:
.sk
.lm+4;.literal
  $ unzip "-VX" -a zipfile
.end literal;.lm-4
.sk
.![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:
.sk
.lm+4;.literal
  $ define UNZIP_OPTS "-qCX"
.end literal;.lm-4
.sk
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 `-':
.sk
.lm+4;.literal
  $ unzip --ql zipfile
.end literal;.lm-4
.sk
or
.sk
.lm+4;.literal
  $ unzip -l-q zipfile
.end literal;.lm-4
.sk
At present it is not possible to decrement an option below zero--that is,
more than a few minuses have no effect.
.sk
UNZIP_OPTS may be defined as a symbol rather than a logical, but if both
are defined, the logical is used.