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