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