home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 9 Archive / 09-Archive.zip / UNZP50P1.ZIP / VMS / unzip.rnh < prev    next >
Text File  |  1993-01-23  |  5KB  |  135 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. .!        Update for UnZip 4.2.
  22. .!    01-003        Igor Mandrichenko    23-MAY-1992 22:14
  23. .!        Add -X option to command syntax.
  24. .!    01-004        Cave Newt        24-MAY-1992 13:30
  25. .!        Add UNZIP_OPTS environment variable help.
  26. .!
  27. .noflags
  28. .lm4 .rm72
  29. .indent -4
  30. 1 UNZIP
  31. .br
  32. UnZip is used to extract files compressed and packaged by Zip (see HELP ZIP
  33. for information on ZIP).
  34. .sk
  35. For a brief help on Zip and Unzip, run each without specifying any
  36. parameters on the command line.
  37. .sk
  38. UNZIP will list, test, or extract from a ZIP archive.  ZIP archives are commonly
  39. found on MS-DOS systems; a VMS version of ZIP can also be found here.
  40. .sk
  41. Archive member extraction is implied by the absence of the -c, -p, -t, -l, -v or
  42. -z options.  All archive members are processed unless a filespec is provided to
  43. specify a subset of the archive members.  The filespec is similar to an egrep
  44. expression, and may contain:
  45. .sk
  46. .literal
  47.      *       matches a sequence of 0 or more characters
  48.      ?       matches exactly 1 character
  49.      \nnn    matches the character having octal code nnn
  50.      [...]   matches any single character found inside the brackets;
  51.              ranges are specified by a beginning character,
  52.              a hyphen, and an ending character.  If a '!' follows
  53.              the left bracket, then the range of characters
  54.              matched is complemented with respect to the ASCII
  55.              character set.
  56. .end literal
  57. .sk
  58. Format:
  59. .sk;.lm+1;.literal
  60. UNZIP [-cflptuvxz[ajnoqUVX]] file[.zip] [filespec...]
  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.  The suffix .ZIP is applied if the
  69. specified file does not exist.  Note that self-extracting ZIP files are
  70. supported; just specify the .EXE suffix yourself.
  71. .sk;.indent -4
  72. [filespec]
  73. .sk
  74. An optional list of archive members to be processed.  Expressions may be
  75. used to match multiple members.  Expressions should be enclosed in double-quotes
  76. to prevent interpretation by DCL.  Multiple filenames should be separated by
  77. blanks.
  78. .!------------------------------------------------------------------------------
  79. .indent -4
  80. 2 Options
  81. .br
  82. The default action of UnZip is to extract all zipfile entries.  The following
  83. options and modifiers can be provided:
  84. .sk;.literal
  85.    -c   extract files to SYS$OUTPUT (terminal)
  86.    -f   freshen existing files (replace if newer); create none
  87.    -l   list archive files (short format)
  88.    -p   extract files to SYS$OUTPUT; no informational messages
  89.    -t   test archive files
  90.    -u   update existing files; create new ones if needed
  91.    -v   list archive files (verbose format)
  92.    -x   extract files in archive (default)
  93.    -z   display only the archive comment
  94. .end literal;.sk;.literal
  95.  MODIFIERS
  96.    -a   convert to VMS textfile format (only use for TEXT files!)
  97.    -j   junk paths (don't recreate archive's directory structure)
  98.    -n   never overwrite existing files; don't prompt
  99.    -o   OK to overwrite files without prompting
  100.    -q   perform operations quietly (-qq => even quieter)
  101.    -U   leave filenames uppercase if created under MS-DOS, VMS, etc.
  102.    -V   retain (VMS) file version numbers
  103.    -X   restore owner/protection info (may require privileges)
  104. .end literal;.sk
  105. ! [this should probably be a separate section]:
  106. In addition, default options may be specified via the UNZIP_OPTS logical.
  107. For example, the following will cause UnZip to restore owner/protection
  108. information and perform all operations at quiet-level 1 by default:
  109. .sk;.literal
  110.     define UNZIP_OPTS "-qX"
  111. .end literal;.sk
  112. Note that the quotation marks are required to preserve lowercase options.
  113. To negate a default option on the command line, add one or more minus 
  114. signs before the option letter, in addition to the leading switch character
  115. `-':
  116. .sk;.literal
  117.     unzip --ql zipfile
  118. .end literal
  119. or
  120. .literal
  121.     unzip -l-q zipfile
  122. .end literal;.sk
  123. At present it is not possible to decrement an option below zero--that is,
  124. more than a few minuses have no effect.
  125. .sk
  126. UNZIP_OPTS may be defined as a symbol rather than a logical, but if both
  127. are defined, the logical is used.
  128. .!-----------------------------------------------------------------------------
  129. .indent -4
  130. 2 Authors
  131. .br
  132. Samuel H. Smith, Usenet contributors, and Info-ZIP.
  133. .sk
  134. VMS on-line help ported from UNZIP.MAN by Hunter Goatley.
  135.