campo-sirio/zip/unzip/vms/unzip_def.rnh

.!
.!  File:	UNZIP_DEF.RNH
.!
.!  Author:	Hunter Goatley
.!
.!  Date:	October 23, 1991
.!
.!  Description:
.!
.!	RUNOFF source file for VMS on-line help for portable UnZip.
.!	Adapted from UNZIP.MAN (now UNZIP.DOC).
.!
.!	To build:	$ REN UNZIP_DEF.RNH UNZIP.RNH
.!			$ RUNOFF UNZIP.RNH
.!			$ LIBR/HELP/INSERT libr UNZIP
.!
.!  Modification history:
.!
.!	01-001		Hunter Goatley		23-OCT-1991 09:21
.!		Genesis.
.!	01-002		Cave Newt		16-MAR-1992 22:37
.!		Updated for UnZip 4.2.
.!	01-003		Igor Mandrichenko	23-MAY-1992 22:14
.!		Added -X option to command syntax.
.!	01-004		Cave Newt		24-MAY-1992 13:30
.!		Added UNZIP_OPTS environment variable help.
.!	01-005		Igor Mandrichenko	14-DEC-1993 18:55
.!		Modified for UnZip V5.1
.!	01-006		Cave Newt		21-DEC-1993 12:38
.!		Added -x option and cleaned up.
.!	01-007		Cave Newt		14-JUL-1994 09:45
.!		Added -Z, -C and -L options, removed -U, minor clean-up.
.!	01-008		Cave Newt		28-JUL-1994 08:57
.!		Removed semi-colons from comments.
.!	02-001		Christian Spieler	09-DEC-1995 02:25
.!		Modified for UnZip 5.2.
.!	02-002		Christian Spieler	06-FEB-1996 02:25
.!		Added -h "help" option.
.!	02-003		Christian Spieler	04-MAR-1997 20:25
.!		Added -P "command line password" option.
.!
.noflags
.lm4 .rm72
.indent -4
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, or specify the -h flag (but not in UnZip's
Zipinfo mode).
.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.
Format:
.sk;.lm+1;.literal
UNZIP [-cfhlptuvxz[ajnoqCLMVX]] file[.zip] [list] [-x xlist] [-d out_dir]
.end literal;.lm-1
.!------------------------------------------------------------------------------
.indent -4
2 Parameters
.sk;.indent -4
file[.zip]
.sk
File specification for the ZIP archive(s) with optional wildcards. UnZip will
perform actions specified for every zipfile matching the specification.
Default file specification is SYS$DISK:[].ZIP.
Note that self-extracting ZIP files are supported; just specify the .EXE
suffix yourself.
.sk;.indent -4
[list]
.sk
An optional 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
.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
.sk
.sk;.indent -4
[-x xlist]
.sk
An optional list of archive members to be excluded from processing.  The xlist
overrides any files included in the normal list.
.sk;.indent -4
[-d out_dir]
.sk
Optional directory specification to be used as target root directory
for files to be extracted.  Directory should be specified in "[.foo]"
format rather than "foo.dir" or "foo/" format.
.!------------------------------------------------------------------------------
.indent -4
2 Options
.br
The default action of UnZip is to extract all zipfile entries.  The following
options and modifiers can be provided:
.sk;.literal
   -Z   ZipInfo mode
   -c   extract files to SYS$OUTPUT (terminal)
   -f   freshen existing files (replace if newer); create none
   -h   show brief help screen and exit quietly
   -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
.end literal;.sk;.literal
 MODIFIERS
   -a   extract text files in standard VMS text file format
   -aa  extract all files as text
   -b   auto-extract only binary files in VMS fixed 512-byte record format
   -bb  extract all files as binary in VMS fixed 512-byte record format
   -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 DOS, VMS, etc.
   -M   feed screen output through built-in "more" pager
   -P<password> supply decryption password on the command line (insecure!)
   -V   retain (VMS) file version numbers
   -X   restore owner/protection info (may require privileges)
.end literal;.sk
Note that uppercase options (-C, -L, -M, -P, -V and -X) must be specified
in quotes. For example:
.sk;.literal
    unzip "-VX" -a zipfile
.end literal;.sk
The output conversion options -b and -a may be combined to perform
binary conversions on binary files and text conversion on text files.
But note: For compatibility with implementation on other systems, -b cancels
any -a option; to get the intended result, -a must be specified AFTER -b.
And, in combination, "text" recognition takes precedence; this means
that -bb has the same effect as -b, and -aa overrides binary conversion
for ALL files.
.sk
Please note that using the "-P<password>" option is higly insecure, the
plaintext password may be seen by others. For this reason (and because of
lack of space), the "-P<password>" option is not advertised on UnZip's
online help screen.
.!------------------------------------------------------------------------------
.indent -4
2 Logical_Names
.br
UnZip allows to modify its default behaviour by specifying option defaults
via the UNZIP_OPTS logical name.
For example, the following will cause UnZip to restore owner/protection
information and perform all operations at quiet-level 1 by default:
.sk;.literal
    define UNZIP_OPTS "-qX"
.end literal;.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;.literal
    unzip --ql zipfile
.end literal
or
.literal
    unzip -l-q zipfile
.end literal;.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 name, but if
both are defined, the logical name takes precedence.
.!-----------------------------------------------------------------------------
.indent -4
2 Authors
.br
Info-ZIP; currently maintained by Greg Roelofs.  VMS support maintained
by Christian Spieler and Hunter Goatley.  Originally based on a program
by Samuel H. Smith.
.sk
VMS on-line help ported from UNZIP.DOC by Hunter Goatley.