home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / packer / infozip / sources / vms.zoo / unzip.rnh < prev    next >
Encoding:
Text File  |  1992-03-17  |  3.7 KB  |  108 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. .!
  23. .noflags
  24. .lm4 .rm72
  25. .indent -4
  26. 1 UNZIP
  27. .br
  28. UnZip is used to extract files compressed and packaged by Zip (see HELP ZIP
  29. for information on ZIP).
  30. .sk
  31. For a brief help on Zip and Unzip, run each without specifying any
  32. parameters on the command line.
  33. .sk
  34. UNZIP will list, test, or extract from a ZIP archive.  ZIP archives are commonly
  35. found on MS-DOS systems; a VMS version of ZIP can also be found here.
  36. .sk
  37. Archive member extraction is implied by the absence of the -c, -p, -t, -l, -v or
  38. -z options.  All archive members are processed unless a filespec is provided to
  39. specify a subset of the archive members.  The filespec is similar to an egrep
  40. expression, and may contain:
  41. .sk
  42. .literal
  43.      *       matches a sequence of 0 or more characters
  44.      ?       matches exactly 1 character
  45.      \nnn    matches the character having octal code nnn
  46.      [...]   matches any single character found inside the brackets;
  47.              ranges are specified by a beginning character,
  48.              a hyphen, and an ending character.  If a '!' follows
  49.              the left bracket, then the range of characters
  50.              matched is complemented with respect to the ASCII
  51.              character set.
  52. .end literal
  53. .sk
  54. Format:
  55. .sk;.lm+1;.literal
  56. UNZIP [-cflptuvxz[ajnoqUV]] file[.zip] [filespec...]
  57. .end literal;.lm-1
  58. .!------------------------------------------------------------------------------
  59. .indent -4
  60. 2 Parameters
  61. .sk;.indent -4
  62. file[.zip]
  63. .sk
  64. File specification for the ZIP archive.  The suffix .ZIP is applied if the
  65. specified file does not exist.  Note that self-extracting ZIP files are
  66. supported; just specify the .EXE suffix yourself.
  67. .sk;.indent -4
  68. [filespec]
  69. .sk
  70. An optional list of archive members to be processed.  Expressions may be
  71. used to match multiple members.  Expressions should be enclosed in double-quotes
  72. to prevent interpretation by DCL.  Multiple filenames should be separated by
  73. blanks.
  74. .!------------------------------------------------------------------------------
  75. .indent -4
  76. 2 Options
  77. .br
  78. The default action of UnZip is to extract all zipfile entries.  The following
  79. options and modifiers can be provided:
  80. .sk;.literal
  81.    -c   extract files to SYS$OUTPUT (terminal)
  82.    -f   freshen existing files (replace if newer); create none
  83.    -l   list archive files (short format)
  84.    -p   extract files to SYS$OUTPUT; no informational messages
  85.    -t   test archive files
  86.    -u   update existing files; create new ones if needed
  87.    -v   list archive files (verbose format)
  88.    -x   extract files in archive (default)
  89.    -z   display only the archive comment
  90. .end literal;.sk;.literal
  91.  MODIFIERS
  92.    -a   convert to VMS textfile format (only use for TEXT files!)
  93.    -j   junk paths (don't recreate archive's directory structure)
  94.    -n   never overwrite existing files; don't prompt
  95.    -o   OK to overwrite files without prompting
  96.    -q   perform operations quietly (-qq => even quieter)
  97.    -U   leave filenames uppercase if created under MS-DOS, VMS, etc.
  98.    -V   retain (VMS) file version numbers
  99.    -X   restore owner/protection info (may require privileges)
  100. .end literal
  101. .!-----------------------------------------------------------------------------
  102. .indent -4
  103. 2 Authors
  104. .br
  105. Samuel H. Smith, Usenet contributors, and Info-ZIP.
  106. .sk
  107. VMS on-line help ported from UNZIP.MAN by Hunter Goatley.
  108.