home *** CD-ROM | disk | FTP | other *** search
/ Go64! / Go64_1999-07_1999_CSW_Side_B.d64 / unzip.docs < prev    next >
Text File  |  2023-02-26  |  9KB  |  357 lines
  1.              Unzip64v2.12
  2.              ------------
  3.  
  4.       Copyright 1998 Errol Smith
  5.  
  6.  
  7. What's New in 2.1?
  8. ------------------
  9.  
  10. - Main inflate routine is now MUCH
  11.   faster than before, (I re-wrote most
  12.   of it from scratch..)
  13.  
  14. - GZIP (*.gz) extraction!
  15.  
  16. - Fixed handling of ZIP's with paths
  17.  
  18. - Extracts some ZIP's made on *nix that
  19.   2.0 wouldn't
  20.  
  21. - 32bit CRC error checking
  22.  
  23. - 2mhz mode on a 128 in 64mode
  24.  
  25. - SCPU optimized
  26.  
  27. - dos command functions
  28.  
  29. - no longer clobbers BASIC on exit
  30.  
  31. - dozens of other internal changes,
  32.   minor bug fixes etc etc..
  33.  
  34.  
  35. Introduction
  36. ------------
  37.  
  38.  Unzip64v2 is a c64 program to extract
  39. 'ZIP' compressed archives created by
  40. PKZIPv2.04g, Info-Zip 2.x or equivalent
  41. programs. (extension '.zip')
  42.  Unzip64v2.12 will also now extract
  43. 'gzip' compressed files. These are made
  44. with the GZIP compression program
  45. commonly used on unix machines, and
  46. have the extension '.gz'.
  47.  
  48.  Unzip64v2 will work on a c64 or c128
  49. in 64 mode. It is also compatible with
  50. most expansion devices such as REU's
  51. (using ramdos) and CMD products such as
  52. hard drives, SCPU's etc. Unzip64v2.1
  53. takes advantage of 2mhz mode on a c128
  54. (in 64 mode) and is CMD SuperCPU
  55. optimized.
  56.  
  57.  This program is free to be distributed
  58. as long as it is in it's original
  59. archive, (UNZP6421.PRG)
  60. NOTE The file is a Self-eXtracting-Zip,
  61. -not- a 'normal' c64 program. Please do
  62. not compress it with something else!
  63. (you won't gain much if you try)
  64.  
  65.  If you find the program useful, I
  66. would appreciate some encouragement to
  67. continue development. A donation of $10
  68. (or more!) is suggested, though an
  69. appreciative email/letter will suffice
  70. if you can't afford a measly $10 or so
  71. contribution (-:
  72.  I would also be happy with donations
  73. of software (eg. if you are a software
  74. author or distributor), or hardware
  75. (eg utility carts - AR, FC etc, or any
  76. CMD device). If you would like to
  77. donate any of the above please contact
  78. me in advance.
  79.  Anyone making a contribution will
  80. recieve acknowledgement in this
  81. documentation and/or on my web page.
  82.  
  83.  I would like to thank all the people
  84. that helped beta test the program and
  85. provided feedback & suggestions.
  86.  
  87.  
  88. Contact Information
  89. -------------------
  90.  
  91.  The latest news & updates of unzip64v2
  92. can be found on my c64 web page at:
  93. http://www.ros.com.au/^errol/64.html
  94. (note the ^ above represents a tilde or
  95. 'squigly line')
  96.  
  97. Internet e-mail: errol@ros.com.au
  98.  
  99. Fidonet Netmail: Errol Smith
  100.                  3:712/523.5
  101.  
  102.  I can also be contacted in any of the
  103. Fidonet CBM, CBM-128 & CBM-GEOS echoes.
  104.  
  105. Snail Mail:
  106.  Errol Smith
  107.  PO Box 119
  108.  Round Corner
  109.  NSW 2158
  110.  Australia
  111.  
  112.  
  113. Important Notes
  114. ---------------
  115.  
  116. * To use RAMDOS with unzip64v2, set the
  117. interface page at 207 ($cf)
  118.  
  119. * Unzip64v2 is always in development,
  120. and may contain bugs. Any bug reports
  121. & suggestions for improvements are
  122. welcome. If reporting a bug I would
  123. apreciate being sent the zipfile that
  124. caused the error (if the program
  125. crashes on a valid zip file).
  126.  
  127. * Unzip64v2 cannot decompress ZIP's
  128. created by PKZIP1.xx. You will need to
  129. use Bill Lucier's Unzip64 or David
  130. Schmolls NZP128 package to decompress
  131. these files. (the exception to this is
  132. if the files are all stored, but that
  133. is unlikely).
  134.  If Unzip64v2 says 'UNSUPPORTED!' when
  135. unzipping then you probably have a
  136. ZIP1.xx archive.
  137.  
  138. * The distribution archive -IS- a self
  139. extracting zip archive. Unfortunately
  140. the code is custom written for this
  141. package and isn't publicly useable.
  142. There are several practical limitations
  143. to using zip for self extracting files,
  144. but I will endeavor to release a
  145. publicly usable 'SXZ' (?) module in the
  146. future.
  147.  I didn't call the distribution an SFX
  148. as it would be confused with LZH SFX
  149. files. I propose the extension 'SXZ'
  150. for future Self eXtracting Zips. Any
  151. comments? Anyone?
  152.  
  153.  
  154. Main Menu
  155. ---------
  156.  
  157.  Most options are reasonably self
  158. explanatory but I'll detail them anyway
  159. to avoid any confusion.
  160.  
  161. F1 - Shows a directory of the source
  162.      device, using the source path.
  163.  
  164. F2 - This toggles the source device
  165.      number. This is the device that
  166.      the .ZIP or .GZ file is on. It
  167.      will automatically find the next
  168.      valid device on your system. Valid
  169.      device numbers are 8 through 30.
  170.  
  171. +  - Change the source path. This is
  172.      only of use to users of CMD drive
  173.      devices, and allows you to set the
  174.      partition & subdirectory for the
  175.      source zip/gz files. The path you
  176.      enter is pre-pended to the input
  177.      file verbatim. It MUST include a
  178.      trailing colon! CMD path example:
  179.      23//mystuff/:
  180.      Where "23" is the partition, "//"
  181.      is the root directory, "mystuff"
  182.      is the subdirectory, and "/:" ends
  183.      the path. Got it?
  184.  
  185. @  - Send a dos command to the source
  186.      device. You can use this to
  187.      scratch, rename, copy etc.
  188.      Hit only return to read the error
  189.      channel without sending a command.
  190.      Enter $ to read the directory of
  191.      the device (note this uses the
  192.      current/default path of the drive,
  193.      NOT the path defined with '+')
  194.  
  195. F3 - Shows a directory of the
  196.      destination device, using the
  197.      destination path.
  198.  
  199. F4 - Toggles the destination device
  200.      number (where the extracted files
  201.      will go). Similar to F2.
  202.  
  203. -  - Change the destination path. This
  204.      is where extracted files will go.
  205.      See notes above about source paths
  206.      & remember the trailing colon.
  207.  
  208. *  - Send a dos command to the
  209.      destination device. Similar to the
  210.      @ command above.
  211.  
  212. F5 - Set zip filename. Allows you to
  213.      set the name of the input file.
  214.  
  215. F6 - Toggle the default output file
  216.      type - P (PRG) or S (SEQ). This is
  217.      the file type that extracted files
  218.      will have. Note you can manually
  219.      override this with individual
  220.      files.
  221.  
  222. F7 - Unzip a file. This starts
  223.      unzipping the specified file. See
  224.      'Unzipping' later on for details.
  225.  
  226. F8 - Change unzip mode. This toggles
  227.      between 'zip' mode for .ZIP files
  228.      & 'gzip' mode for .GZ files.
  229.      Select the appropriate mode before
  230.      hitting F7!
  231.  
  232. q  - Quit unzip64v2 & return to basic.
  233.      Press 'Q' (shift-q) for an AR
  234.      friendly reset.
  235.  
  236.  Generally to use unzip64v2, you set
  237. the appropriate source & destination
  238. devices (and paths if needed), set the
  239. zip file name with F5, then start
  240. unzipping with F7.
  241.  
  242.  
  243. UnZipping - Zip files
  244. ---------
  245.  
  246.  Unzipping handles files within the zip
  247. archive one at a time. As each file is
  248. processed, the filename will be
  249. displayed, followed by a query with
  250. options [ynqaps]. Each letter means the
  251. following:
  252.  
  253. y - Extract this file using the default
  254.     file type.
  255. n - Do not extract this file & skip
  256.     to the next one.
  257. q - Quit unzipping & return to the menu
  258. a - Extract this file and ALL remaining
  259.     files without further prompts,
  260.     using the default file type.
  261. p - Extract this file as a PRG file,
  262.     regardless of the default type.
  263. s - Extract this file as a SEQ file,
  264.     regardless of the default type.
  265.  
  266.  Simply press the letter of the option
  267. you want.
  268.  
  269.  
  270. Unzipping - Gzip files
  271.  
  272.  There are no options for gzip files,
  273. as they contain only one file. The file
  274. is decompressed automatically when you
  275. press F7.
  276.  
  277.  
  278. Unzipping - General
  279.  
  280.  The screen border will flash during
  281. decompression (inflating). This is to
  282. indicate activity, and for debugging.
  283.  When a file is finished being
  284. extracted, you will normally get an OK.
  285. This means the file passed the 32bit
  286. CRC check. If you get a 'CRC error',
  287. then the extracted file is corrupted,
  288. which usually means the ZIP or GZ file
  289. it came from is also corrupt.
  290.  Please ensure there is adequate disk
  291. space on the destination drive before
  292. beginning!
  293.  
  294.  
  295.  
  296. Past, Present & Future
  297. ----------------------
  298.  
  299.  This program has been in development
  300. part-time for over 2 years (since late
  301. 1995). I began the project primarily as
  302. a self-education on compression theory.
  303. It was also a shift from my previous C=
  304. experience which was mostly as a demo
  305. coder ('Strobe').
  306.  
  307.  The program code is based partly on
  308. publicly available C source
  309. (eg. Info-Unzip) along with many other
  310. sources of information on compression
  311. theory, and the deflate algorithm in
  312. particular.
  313.  
  314.  I have many ideas for the future, both
  315. my own and that of the many people who
  316. have provided input to this program
  317. during development. Though I can't
  318. promise to do all (or any) of them,
  319. here are some of the ideas for future
  320. versions:      (in no particular order)
  321.  - User Interface improvements
  322.  - Native 128 version
  323.  - Ability to list the files in a zip
  324.    without extracting them
  325.  - Pick list for choosing source zips
  326.  - Creation of stored zip files.
  327.  - Creation of compressed zip files (!)
  328.  - Self eXtracting Zip routine (SXZ)
  329.    for general public use.
  330.  - Decompression of zip1.xx archives
  331.    (imploded, shrunk, reduced)
  332.  - Decompression of D64 files (emulator
  333.    disk image) directly to a 1541 disk.
  334.  
  335.  Which of these is done and when will
  336. be determined largely by user feedback
  337. as to what people want, how much
  338. inspiration I have, what is practical,
  339. and how much encouragement I get! (-:
  340.  Compression is a large step, and might
  341. be difficult to achieve on a stock 64.
  342. Creation of stored-only zip archives is
  343. relatively easier, but the usefulness
  344. of uncompressed archives is perhaps
  345. questionable.
  346.  
  347.  Anyway, comments, constructive
  348. criticism or cash payments are all
  349. welcome! <grin>
  350.  
  351. Errol Smith
  352.  
  353. Strobe/???
  354.  
  355. End.
  356.  
  357.