home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 9 Archive / 09-Archive.zip / unzip52.zip / vms / unzip_def.rnh < prev    next >
Text File  |  1996-02-07  |  7KB  |  183 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. .!    02-001        Christian Spieler    09-DEC-1995 02:25
  36. .!        Modified for UnZip 5.2.
  37. .!    02-002        Christian Spieler    06-FEB-1996 02:25
  38. .!        Added -h "help" option.
  39. .!
  40. .noflags
  41. .lm4 .rm72
  42. .indent -4
  43. 1 UNZIP
  44. .br
  45. UnZip is used to extract files compressed and packaged by Zip (see HELP ZIP
  46. for information on ZIP).
  47. .sk
  48. For a brief help on Zip and Unzip, run each without specifying any
  49. parameters on the command line, or specify the -h flag (but not in UnZip's
  50. Zipinfo mode).
  51. .sk
  52. UNZIP will list, test, or extract from a ZIP archive.  ZIP archives are commonly
  53. found on MS-DOS systems; a VMS version of ZIP can also be found here.
  54. .sk
  55. Archive member extraction is implied by the absence of the -c, -p, -t, -l, -v or
  56. -z options.  All archive members are processed unless a filespec is provided to
  57. specify a subset of the archive members.
  58. Format:
  59. .sk;.lm+1;.literal
  60. UNZIP [-cfhlptuvxz[ajnoqCLMVX]] file[.zip] [list] [-x xlist] [-d out_dir]
  61. .end literal;.lm-1
  62. .!------------------------------------------------------------------------------
  63. .indent -4
  64. 2 Parameters
  65. .sk;.indent -4
  66. file[.zip]
  67. .sk
  68. File specification for the ZIP archive(s) with optional wildcards. UnZip will
  69. perform actions specified for every zipfile matching the specification.
  70. Default file specification is SYS$DISK:[].ZIP.
  71. Note that self-extracting ZIP files are supported; just specify the .EXE
  72. suffix yourself.
  73. .sk;.indent -4
  74. [list]
  75. .sk
  76. An optional list of archive members to be processed; if no list is given, all
  77. archive members are processed.  Expressions may be
  78. used to match multiple members.  Expressions should be enclosed in double-quotes
  79. to prevent interpretation by DCL.  Multiple filenames should be separated by
  80. blanks.  Each file specification is similar to a Unix egrep expression and may
  81. contain:
  82. .sk
  83. .literal
  84.      *       matches a sequence of 0 or more characters
  85.      ?       matches exactly 1 character
  86.      [...]   matches any single character found inside the brackets;
  87.              ranges are specified by a beginning character,
  88.              a hyphen, and an ending character.  If a '!' or '^'
  89.              immediately follows the left bracket, then any character
  90.              not in the given range is matched.
  91. .end literal
  92. .sk
  93. .sk;.indent -4
  94. [-x xlist]
  95. .sk
  96. An optional list of archive members to be excluded from processing.  The xlist
  97. overrides any files included in the normal list.
  98. .sk;.indent -4
  99. [-d out_dir]
  100. .sk
  101. Optional directory specification to be used as target root directory
  102. for files to be extracted.  Directory should be specified in "[.foo]"
  103. format rather than "foo.dir" or "foo/" format.
  104. .!------------------------------------------------------------------------------
  105. .indent -4
  106. 2 Options
  107. .br
  108. The default action of UnZip is to extract all zipfile entries.  The following
  109. options and modifiers can be provided:
  110. .sk;.literal
  111.    -Z   ZipInfo mode
  112.    -c   extract files to SYS$OUTPUT (terminal)
  113.    -f   freshen existing files (replace if newer); create none
  114.    -h   show brief help screen and exit quietly
  115.    -l   list archive files (short format)
  116.    -p   extract files to SYS$OUTPUT; no informational messages
  117.    -t   test archive files
  118.    -u   update existing files; create new ones if needed
  119.    -v   list archive files (verbose format)
  120.    -z   display only the archive comment
  121. .end literal;.sk;.literal
  122.  MODIFIERS
  123.    -a   extract text files in standard VMS text file format
  124.    -aa  extract all files as text
  125.    -b   auto-extract only binary files in VMS fixed 512 record file format 
  126.    -bb  extract all files as binary in VMS fixed 512 byte record format
  127.    -j   junk paths (don't recreate archive's directory structure)
  128.    -n   never overwrite existing files; don't prompt
  129.    -o   OK to overwrite files without prompting
  130.    -q   perform operations quietly (-qq => even quieter)
  131.    -C   match filenames case-insensitively
  132.    -L   convert filenames to lowercase if created under DOS, VMS, etc.
  133.    -M   feed screen output through built-in "more" pager
  134.    -V   retain (VMS) file version numbers
  135.    -X   restore owner/protection info (may require privileges)
  136. .end literal;.sk
  137. Note that uppercase options (-C, -L, -M, -V and -X) must be specified in
  138. quotes. For example:
  139. .sk;.literal
  140.     unzip "-VX" -a zipfile
  141. .end literal;.sk
  142. The output conversion options -b and -a may be combined to perform
  143. binary conversions on binary files and text conversion on text files.
  144. But note: For compatibility with implementation on other systems, -b cancels
  145. any -a option; to get the intended result, -a must be specified AFTER -b.
  146. And, in combination, "text" recognition takes precedence; this means
  147. that -bb has the same effect as -b, and -aa overrides binary conversion
  148. for ALL files.
  149. .sk
  150. .![this should probably be a separate section]:
  151. In addition, default options may be specified via the UNZIP_OPTS logical.
  152. For example, the following will cause UnZip to restore owner/protection
  153. information and perform all operations at quiet-level 1 by default:
  154. .sk;.literal
  155.     define UNZIP_OPTS "-qX"
  156. .end literal;.sk
  157. Note that the quotation marks here are required to preserve lowercase options
  158. (opposite of the command-line behavior).
  159. To negate a default option on the command line, add one or more minus 
  160. signs before the option letter, in addition to the leading switch character
  161. `-':
  162. .sk;.literal
  163.     unzip --ql zipfile
  164. .end literal
  165. or
  166. .literal
  167.     unzip -l-q zipfile
  168. .end literal;.sk
  169. At present it is not possible to decrement an option below zero--that is,
  170. more than a few minuses have no effect.
  171. .sk
  172. UNZIP_OPTS may be defined as a symbol rather than a logical, but if both
  173. are defined, the logical is used.
  174. .!-----------------------------------------------------------------------------
  175. .indent -4
  176. 2 Authors
  177. .br
  178. Info-ZIP; currently maintained by Greg Roelofs.  VMS support maintained
  179. by Igor Mandrichenko and Hunter Goatley.  Originally based on a program
  180. by Samuel H. Smith.
  181. .sk
  182. VMS on-line help ported from UNZIP.DOC by Hunter Goatley.
  183.