home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 9 Archive / 09-Archive.zip / unzip51.zip / vms / unzip.rnh < prev    next >
Text File  |  1994-01-26  |  6KB  |  158 lines
  1. .!
  2. .!  File:    UNZIP.RNH
  3. .!
  4. .!  Author:    Hunter Goatley
  5. .!
  6. .!  Date:    October 23, 1991
  7. .!
  8. .!  Description:
  9. .!
  10. .!    RUNOFF source file for portable UNZIP on-line help for VMS.
  11. .!    Adapted from UNZIP.MAN, distributed with UNZIP.
  12. .!
  13. .!    To build:    $ RUNOFF UNZIP.RNH
  14. .!            $ LIBR/HELP/INSERT libr UNZIP
  15. .!
  16. .!  Modification history:
  17. .!
  18. .!    01-001        Hunter Goatley        23-OCT-1991 09:21
  19. .!        Genesis.
  20. .!    01-002        Cave Newt        16-MAR-1992 22:37
  21. .!        Updated for UnZip 4.2.
  22. .!    01-003        Igor Mandrichenko    23-MAY-1992 22:14
  23. .!        Added -X option to command syntax.
  24. .!    01-004        Cave Newt        24-MAY-1992 13:30
  25. .!        Added UNZIP_OPTS environment variable help.
  26. .!    01-005        Igor Mandrichenko    14-DEC-1993 18:55
  27. .!        Modified for UnZip V5.1
  28. .!    01-006        Cave Newt        21-DEC-1993 12:38
  29. .!        Added -x option and cleaned up.
  30. .!
  31. .noflags
  32. .lm4 .rm72
  33. .indent -4
  34. 1 UNZIP
  35. .br
  36. UnZip is used to extract files compressed and packaged by Zip (see HELP ZIP
  37. for information on ZIP).
  38. .sk
  39. For a brief help on Zip and Unzip, run each without specifying any
  40. parameters on the command line.
  41. .sk
  42. UNZIP will list, test, or extract from a ZIP archive.  ZIP archives are commonly
  43. found on MS-DOS systems; a VMS version of ZIP can also be found here.
  44. .sk
  45. Archive member extraction is implied by the absence of the -c, -p, -t, -l, -v or
  46. -z options.  All archive members are processed unless a filespec is provided to
  47. specify a subset of the archive members.
  48. Format:
  49. .sk;.lm+1;.literal
  50. UNZIP [-cflptuvxz[ajnoqUVX]] file[.zip] [list] [-x xlist] [-d out_dir]
  51. .end literal;.lm-1
  52. .!------------------------------------------------------------------------------
  53. .indent -4
  54. 2 Parameters
  55. .sk;.indent -4
  56. file[.zip]
  57. .sk
  58. File specification for the ZIP archive(s) with optional wildcards. UnZip will
  59. perform actions specified for every zipfile matching the specification.
  60. Default file specification is SYS$DISK:[].ZIP.
  61. Note that self-extracting ZIP files are supported; just specify the .EXE
  62. suffix yourself.
  63. .sk;.indent -4
  64. [list]
  65. .sk
  66. An optional list of archive members to be processed; if no list is given, all
  67. archive members are processed.  Expressions may be
  68. used to match multiple members.  Expressions should be enclosed in double-quotes
  69. to prevent interpretation by DCL.  Multiple filenames should be separated by
  70. blanks.  Each file specification is similar to a Unix egrep expression and may
  71. contain:
  72. .sk
  73. .literal
  74.      *       matches a sequence of 0 or more characters
  75.      ?       matches exactly 1 character
  76.      [...]   matches any single character found inside the brackets;
  77.              ranges are specified by a beginning character,
  78.              a hyphen, and an ending character.  If a '!' or '^'
  79.              immediately follows the left bracket, then any character
  80.              not in the given range is matched.
  81. .end literal
  82. .sk
  83. .sk;.indent -4
  84. [-x xlist]
  85. .sk
  86. An optional list of archive members to be excluded from processing.  The xlist
  87. overrides any files included in the normal list.
  88. .sk;.indent -4
  89. [-d out_dir]
  90. .sk
  91. Optional directory specification to be used as target root directory
  92. for files to be extracted.  Directory should be specified in "[.foo]"
  93. format rather than "foo.dir" or "foo/" format.
  94. .!------------------------------------------------------------------------------
  95. .indent -4
  96. 2 Options
  97. .br
  98. The default action of UnZip is to extract all zipfile entries.  The following
  99. options and modifiers can be provided:
  100. .sk;.literal
  101.    -c   extract files to SYS$OUTPUT (terminal)
  102.    -f   freshen existing files (replace if newer); create none
  103.    -l   list archive files (short format)
  104.    -p   extract files to SYS$OUTPUT; no informational messages
  105.    -t   test archive files
  106.    -u   update existing files; create new ones if needed
  107.    -v   list archive files (verbose format)
  108.    -x   extract files in archive (default)
  109.    -z   display only the archive comment
  110. .end literal;.sk;.literal
  111.  MODIFIERS
  112.    -a   extract text files in standard VMS text file format
  113.    -aa  extract all files as text
  114.    -j   junk paths (don't recreate archive's directory structure)
  115.    -n   never overwrite existing files; don't prompt
  116.    -o   OK to overwrite files without prompting
  117.    -q   perform operations quietly (-qq => even quieter)
  118.    -U   leave filenames uppercase if created under MS-DOS, VMS, etc.
  119.    -V   retain (VMS) file version numbers
  120.    -X   restore owner/protection info (may require privileges)
  121. .end literal;.sk
  122. Note that uppercase options such as -X,-V,-U must be specified in quotes.
  123. For example:
  124. .sk;.literal
  125.     unzip "-VX" -a zipfile
  126. .end literal;.sk
  127. .![this should probably be a separate section]:
  128. In addition, default options may be specified via the UNZIP_OPTS logical.
  129. For example, the following will cause UnZip to restore owner/protection
  130. information and perform all operations at quiet-level 1 by default:
  131. .sk;.literal
  132.     define UNZIP_OPTS "-qX"
  133. .end literal;.sk
  134. Note that the quotation marks here are required to preserve lowercase options
  135. (opposite of the command-line behavior).
  136. To negate a default option on the command line, add one or more minus 
  137. signs before the option letter, in addition to the leading switch character
  138. `-':
  139. .sk;.literal
  140.     unzip --ql zipfile
  141. .end literal
  142. or
  143. .literal
  144.     unzip -l-q zipfile
  145. .end literal;.sk
  146. At present it is not possible to decrement an option below zero--that is,
  147. more than a few minuses have no effect.
  148. .sk
  149. UNZIP_OPTS may be defined as a symbol rather than a logical, but if both
  150. are defined, the logical is used.
  151. .!-----------------------------------------------------------------------------
  152. .indent -4
  153. 2 Authors
  154. .br
  155. Info-ZIP, originally based on a program by Samuel H. Smith.
  156. .sk
  157. VMS on-line help ported from UNZIP.DOC by Hunter Goatley.
  158.