home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / COMPRESS / ZIPUP1_3.ZIP / ZIPUP1_3.DOC < prev   
Encoding:
Text File  |  1990-08-08  |  6.5 KB  |  189 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                              ZIPUP Version 1.3
  20.  
  21.                        "ZIP Comment Stripper/Adder"
  22.  
  23.  
  24.  
  25.  
  26.                                 Written by:
  27.  
  28.                                 Bob Jaques
  29.  
  30.                                     and
  31.  
  32.                                  Jim Barth
  33.  
  34.  
  35.  
  36.  
  37. PURPOSE
  38. -------
  39.  
  40. "ZIPUP" is a handy utility written and compiled in Turbo C++ 1.0 that will
  41. add comments to user-supplied files that are compressed under Phil Katz's
  42. PKZIP compression routines.  ZIPUP is flexible and configurable to fit the
  43. needs of most who would use this type of program.  This utility has been
  44. tested under all known possible combinations and has proven to be
  45. reliable, fast and easy-to-use, but we, the authors, can take no liability
  46. nor provide any guarantee for the use of this program.  If you come across
  47. a problem or a suggestion to make this routine better and more efficient,
  48. please drop us a line as we would like to hear your comments.  At any rate,
  49. please share this program with others.
  50.  
  51.  
  52.  
  53. COST
  54. ----
  55.  
  56. There is no cost!  This utility is not Shareware, commercial or public
  57. domain.  Instead, it is "PostWare", meaning that if you like it and find it
  58. useful, we would appreciate you sending us a postcard from your locale
  59. letting us know that you are using it.  Or, drop one or the other of the
  60. authors a FIDO-Net NETMAIL message letting us know your comments on the
  61. utility.
  62.  
  63.     Bob Jaques    (1:3607/21 12-9600HST)    Jim Barth   (1:350/21 12-2400)
  64.     Rt. 7 Box 415                           11544 Kevin Lane NE
  65.     Cullman, AL  35055                      Poulsbo, WA  98370
  66.  
  67.  
  68. USAGE
  69. -----
  70.  
  71. ZIPUP will accept up to two command line arguments to process your ZIP
  72. files in the general format of:
  73.  
  74.                ZIPUP C:\PATH\ZIPFILE.ZIP C:\PATH\COMMENT.TXT
  75.  
  76. If no argument for the comment path\filename is entered, ZIPUP will
  77. automatically default to use a comment file called ZIPUP.TXT, which should
  78. be in the same directory that ZIPUP is run from.  The comment file is
  79. simply any ASCII or ANSI file that you create with your word processor or text
  80. editor (such as DOS' EDLIN.COM) and is often used to personalize a bulletin
  81. board's downloadable files.  There is an upper size limit to the length of
  82. the comment file that can be inserted to a ZIP file by ZIPUP, which is
  83. around 65,000 bytes -- a little unfeasible in our opinion.
  84.  
  85. If there are already comments attached to the ZIP files that ZIPUP will
  86. process, ZIPUP will automatically replace those "old" comments with the
  87. comment specified in your comment file.  This is a handy fix for users who
  88. upload ZIP files to a BBS that still has comments from the BBS he may have
  89. just downloaded it from.
  90.  
  91.  
  92.  
  93.  
  94.  
  95. EXAMPLES
  96. --------
  97.  
  98. Here are some valid examples for the use of ZIPUP:
  99. ZIPUP                                  => Program will prompt for .ZIP file 
  100.                                           name and comment file name.
  101.  
  102. ZIPUP *.*                   => Adds a comment to all .ZIP files
  103.                                           in the current directory using
  104.                                           a default comment file of
  105.                                           ZIPUP.TXT.
  106.  
  107. ZIPUP *.ZIP                   => Effectivly the same as the above
  108.                       example.  Will run slightly 
  109.                                           faster as it doesn't have to check
  110.                                           whether the file has a .ZIP
  111.                                           extension.  
  112.  
  113. ZIPUP ZIPFILE.* COMMENT.TXT            => Adds the comment stored in
  114.                                           COMMENT.TXT to the specific file
  115.                                           ZIPFILE.ZIP.  Program will ignore
  116.                       anything but a .ZIP file 
  117.                       automatically.
  118.  
  119. ZIPUP ZIPFILE.ZIP COMMENT.TXT          => Exact same results as above
  120.                                           example.  Runs slightly faster as 
  121.                                           it doesn't have to check whether
  122.                                           the file has the .ZIP extension.
  123.   
  124. ZIPUP E:\BBS\UPLOAD\*.ZIP C:\ZIPUP.TXT => Adds the comment stored in
  125.                                           C:\ZIPUP.TXT to all ZIP files
  126.                                           found in E:\BBS\UPLOAD\
  127.  
  128.  
  129. ERROR LEVELS
  130. ------------
  131.  
  132. Since ZIPUP was written to be easily run from a batch file, two possible
  133. ERRORLEVELS are set after the program has run.  If no errors were
  134. encountered during program execution, the ERRORLEVEL will be set to '0'.
  135. If, on the other hand, ZIPUP was unable to execute flawlessly, the returned
  136. ERRORLEVEL will be set to '1'.  After running this routine for a while, we
  137. have noticed that perhaps a couple more ERRORLEVELS would be handy to
  138. indicate specific "problems", this will be added in a future update.
  139.  
  140. SOURCE CODE
  141. -----------
  142.  
  143. This utility came about as a result a combination of the authors wanting to
  144. know more about the structures used in ZIP files and writing a useful
  145. utility incorporating this knowledge.  Obviously, there is no secret to the
  146. algorithms used to create this utility and if you would like a copy of the
  147. 'C' source code, it can be File Requested via FIDONET as ZIPUPSRC.ZIP from
  148. the authors.
  149.  
  150.  
  151.  
  152.  
  153. HISTORY
  154. -------
  155. Version 1.3
  156.    
  157.    Added code to prompt for .ZIP file name and Comment file name if they
  158.    aren't found on the command line. Some late releases of Version 1.2
  159.    had this feature.
  160.    Added some code to retain the original date of the .ZIP file.  This was
  161.    requested by some of the users who don't get a chance to process the 
  162.    uploads on there BBS the same day they get them.
  163.    Sped up the display of the working indicator to show activity better 
  164.    when ZIPUP is used on a network.  I am working on a full Netbios
  165.    Compatible version at this time.
  166.  
  167. Version 1.2
  168.  
  169.    Improved the command line use of Wildcards. All DOS wildcards are now
  170.    supported.
  171.    Added error messages for non-fatal errors.
  172.    Changed display to look similar to PKZIP.
  173.    Added indicator to tell when program is actually working. (Thanks, Phil!)
  174.  
  175. Version 1.1
  176.     
  177.    Fixed major bug that cropped up when you tried to add a shorter comment 
  178.    to the ZIP file than what was there before.  The program used to just
  179.    skip over the offending .ZIP file and go on to the next one.
  180.    Introduced limited wildcard usage.
  181.    Fixed minor bugs that were reported in Version 1.0.
  182.    Modified display of program to show file that have been processed.
  183.  
  184. Version 1.0  10-15-89
  185.     
  186.    The first release. 
  187.  
  188.  
  189.