home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / COMPRESS / ZC100.ZIP / ZC.DOC < prev    next >
Encoding:
Text File  |  1991-03-11  |  9.4 KB  |  240 lines
  1.           ┌────────────────────────────────────────────────┐
  2.           │ Zip Chunker, (C) Copyright 1991, Scott Jibben  │
  3.           │                 Version 1.0                    │
  4.           └────────────────────────────────────────────────┘
  5.  
  6.  
  7.     This is a list of the files that should accompany this software
  8.     package:
  9.  
  10.     ZC.EXE         14624  03-11-91  1:00am
  11.     ZC.DOC          9625  03-11-91  1:00am
  12.     ORDER.FRM       1900  03-11-91  1:00am
  13.     VER-HIST.TXT    2195  03-11-91  1:00am
  14.  
  15.  
  16.     This software has been compressed using PKLite Professional.
  17.  
  18.  
  19.  
  20.                          What this software does
  21.  
  22.     This software will take an existing ZIP (tm) file that was created
  23.     using PKWare's PKZIP (tm) software and create subsets of the file
  24.     according to a users specified size.  These subsets are
  25.     uncompressed as normal using PKUNZIP (tm).
  26.  
  27.  
  28.  
  29.                       Requirements for Zip Chunker
  30.  
  31.     Zip Chunker allocates memory as needed when processing.  However, I
  32.     suggest that you have at least 200KB of free memory to run Zip Chunker.
  33.     If you are going to process large Zip files (with a lot of files, not
  34.     total size), I suggest that you have 350KB of free memory to run
  35.     Zip Chunker.
  36.                      Advantages of Using Zip Chunker
  37.  
  38.  
  39.  
  40.     I've designed Zip Chunker to make the least demands on your
  41.     hardware.  Zip Chunker is at least 2 times faster than any other
  42.     software package of this type.  In some instances, I've found it to
  43.     be up to 10 times faster.
  44.  
  45.     One other benefit from using Zip Chunker is the amount of disk
  46.     space it requires to process a ZIP file.  My closest competitor
  47.     requires 2-3 times the disk space of the original ZIP file, ie, if
  48.     you had a 2MB ZIP file you would have to have up to 6MB of free
  49.     disk space in order to break it up!  Zip Chunker requires the
  50.     amount of the original ZIP file plus 16KB for free space, ie, if
  51.     you had a 2MB file you would only need 2MB + 16KB free in order to
  52.     use Zip Chunker.
  53.  
  54.     The algorithm in which I calculate the amount of files to put in a
  55.     ZIP chunk is highly optimized.  Zip Chunker will sometimes have one
  56.     less chunk than other software packages of this type and the chunks
  57.     will be closer to the requested size.
  58.  
  59.     Zip Chunker can handle any file created using PKZIP (tm).  All other
  60.     software packages of this type that I've seen, have the tendency to
  61.     crash if the ZIP file is too large or there are too many files in
  62.     the ZIP file.  One of my beta testers ran ZC on a 170 Megabyte Zip
  63.     file and ZC processed it without problems.
  64.  
  65.  
  66.  
  67.  
  68.     Sysops,
  69.  
  70.     If you would like to be a distribution point for this software, I
  71.     would be happy to talk to you about the best way to get it to you.
  72.     Please send a letter or email to me with your phone/BBS number on
  73.     one of the computer systems I have listed in the license screen (ZC
  74.     /L).  These systems are also listed in the Technical Support section
  75.     of this document.
  76.  
  77.                             Using Zip Chunker
  78.  
  79.  
  80.  
  81.     The software is fairly straight-forward and easy to use.  In fact,
  82.     I doubt that you will need to read this document in order to be
  83.     able to use the software.  Zip Chunker will always display all of
  84.     your options when you just type in ZC and press Enter.  Below is an
  85.     example of what you will see when you do this:
  86.  
  87.     ■───────────────────────────────────────────────────────────────■
  88.  
  89.     Zip Chunker 1.0.  Released: 03-11-91
  90.     Copyright 1991, Scott Jibben.  All Rights Reserved.
  91.  
  92.     Syntax:  ZC [/L] | [zipfile [# | /5L | /5H | /3L | /3H] [/S]]
  93.  
  94.     [/L]      - License information.
  95.     [zipfile] - Name of Zip file to be sized.
  96.  
  97.     [#]       - Maximum size of the produced Zip files in bytes.
  98.     [/5L]     - Maximum size = 5.25" Low Density Floppy Disk (360KB).
  99.     [/5H]     - Maximum size = 5.25" High Density Floppy Disk (1.2MB).
  100.     [/3L]     - Maximum size = 3.5" Low Density Floppy Disk (720KB).
  101.     [/3H]     - Maximum size = 3.5" High Density Floppy Disk (1.44MB).
  102.  
  103.     [/S]      - Don't delete [zipfile].
  104.  
  105.     ■───────────────────────────────────────────────────────────────■
  106.  
  107.     The important line to note is the Syntax line.  It contains the
  108.     basic information on what parameters can be used and in what order
  109.     they should appear.  First of all, every parameter that is enclosed
  110.     in brackets [] is an optional item.  The "|" character means OR.
  111.      The best way to explain how it works is to give some examples, so
  112.     here goes:
  113.  
  114.     C:\WORK\>ZC \L
  115.  
  116.     The example above will display Zip Chunkers license information.
  117.  
  118.  
  119.     C:\WORK\>zc workdata /s
  120.  
  121.     The above example will break out chunks from WORKDATA.ZIP that will
  122.     be equal to or smaller than the size of a file that would fit on a
  123.     3.5" HD disk.  It will also save the original file, WORKDATA.ZIP.
  124.  
  125.  
  126.     C:\WORK\>zc 123data /5L
  127.  
  128.     The above example will break out chunks from 123DATA.ZIP and these
  129.     chunks will be equal to or smaller than what would fit on a 5.25"
  130.     low density disk.  It will delete 123DATA.ZIP when it is done.
  131.  
  132.  
  133.     C:\TELIX\UL\>zc e:\games\biggame 200000 /s
  134.  
  135.     The above example will break out chunks from E:\GAMES\BIGGAME.ZIP
  136.     and these chunks will be equal to or smaller than 200,000 bytes.
  137.     The original file, E:\GAMES\BIGGAME.ZIP, will be saved as well.
  138.     Also, the new ZIP chunks will be created in C:\TELIX\UL.
  139.  
  140.  
  141.  
  142.                               Miscellaneous
  143.  
  144.     Zip Chunker will not allow you to process a ZIP file if there isn't
  145.     enough free disk space available.
  146.  
  147.     If Zip Chunker finds a file in the original ZIP file that is larger
  148.     than the maximum size specified, it will give you the option of
  149.     continuing to process the ZIP file.  The result of this type of
  150.     operation is that there will be some ZIP chunks that have only one
  151.     file in them but they will still be larger than the maximum size.
  152.  
  153.     If the original ZIP file is already smaller than the maximum size
  154.     then Zip Chunker will tell you and not process the ZIP file.
  155.  
  156.     Zip Chunker will in most cases be able to detect that a file passed
  157.     to it is a valid ZIP file or not.  It will not be able to detect if
  158.     the internal files have been corrupted, though.  I plan to add an
  159.     option in a future version that also does CRC-32 checking as it
  160.     processes the Zip file.
  161.  
  162.     Zip Chunker CAN handle password encrypted files and retain the
  163.     password in the ZIP chunks.
  164.                              Technical Data
  165.  
  166.     Zip Chunker was written entirely in C using Borland C++ 2.0.  This
  167.     is a partial explanation of ZC's speed and size.  The other main
  168.     reason for ZC's speed and size is that I have made great use of
  169.     dynamically allocated memory routines.
  170.  
  171.  
  172.                            Technical Support
  173.  
  174.     For technical support I can be reached at the following on-line
  175.     systems:
  176.  
  177.     The Warehouse BBS:  612-729-0160  1200-38400 baud V.32bis/HST (N81)
  178.     The Warehouse is my first (main) line of support.  Since I am a
  179.     co-sysop of this BBS, I usually log on several times a day to check it
  180.     out.  This BBS is a subscription BBS, however anyone logging on
  181.     will receive access rights to the file area where my utilities can
  182.     be downloaded and a message area that is dedicated to my software.
  183.  
  184.  
  185.     CompuServe:
  186.     My CompuServe ID is 72657,3303.  Feel free to send me an E-Mail any
  187.     time.  I usually log on to CompuServe at least once a day.
  188.  
  189.  
  190.     Nick's Nest BBS:  612-490-1187  1200-2400 baud  (N81)
  191.                       612-490-0341  9600 baud only (HST) (N81)
  192.     Nick's Nest is run locally to me and the Sysop is a good friend of
  193.     mine.  This is also a subscription BBS (a mere $10 a year), however
  194.     you will have access to send me messages via E-Mail (message area 1).
  195.  
  196.  
  197.     Painter's Workshop BBS: 414-722-2069  1200-19200 baud (V.32) (N81)
  198.     Painter's Workshop is my Wisconsin connection.  It is another board
  199.     that is operated by a friend of mine.  Painter's Workshop is an
  200.     open BBS, you will have access to downloading and messages immediately.
  201.     I usually log on to this BBS 2-3 times a week.
  202.  
  203.                             Gratituities
  204.  
  205.  
  206.     I would like to thank those people that have assisted me in the
  207.     development of this software:
  208.  
  209.     Chris Edmonson, who gave me some valuable insight on various
  210.     methods of designing the dynamic memory allocation code.
  211.  
  212.     Travis Carter, sysop of the Warehouse BBS, for testing the software
  213.     and providing a message forum for supporting software written by
  214.     me.
  215.  
  216.     Chris Reagan (Painter), sysop of Painter's Workshop, for distributing
  217.     my software all over eastern Wisconsin.
  218.  
  219.     My wife, for the patient support.
  220.  
  221.  
  222.  
  223.  
  224.                          Disclaimers, etc.
  225.  
  226.  
  227.     Scott Jibben specifically disclaims all other warranties, expressed
  228.     or implied, including but not limited to implied warranties of
  229.     merchantability and fitness for a particular purpose, functionality
  230.     or data integrity.  In no event shall Scott Jibben be liable for any
  231.     loss of profit or any other commercial damage, including but not
  232.     limited to special, incidental, consequential or other damages.
  233.  
  234.  
  235.  
  236.     Borland is a registered trademark of Borland International, Inc.
  237.  
  238.     PKWARE, PKLITE, PKZIP and PKUNZIP are registered trademarks of PKWare
  239.     Incorporated.
  240.