home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / arc / zipup1_1.lzh / ZIPUP1_1.DOC < prev   
Text File  |  1989-10-16  |  5KB  |  142 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                              ZIPUP Version 1.1
  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.  
  38.  
  39. PURPOSE
  40. -------
  41.  
  42. "ZIPUP" is a handy utility written and compiled in Turbo C 2.0 that will
  43. add comments to user-supplied files that are compressed under Phil Katz's
  44. PKZIP compression routines.  ZIPUP is flexible and configurable to fit the
  45. needs of most who would use this type of program.This utility has been
  46. tested under all known possible combinations and has proven to be
  47. reliable, fast and easy-to-use, but we, the authors, can take no liability
  48. nor provide any guarantee for the use of this program.  If you come across
  49. a problem or a suggestion to make this routine better and more efficient,
  50. please drop us a line as we would like to hear your comments.  At any rate,
  51. please share this program with others.
  52.  
  53.  
  54.  
  55. COST
  56. ----
  57.  
  58. There is no cost!  This utility is not Shareware, commercial or public
  59. domain.  Instead, it is "PostWare", meaning that if you like it and find it
  60. useful, we would appreciate you sending us a postcard from your locale
  61. letting us know that you are using it.  Or, drop one or the other of the
  62. authors a FIDO-Net NETMAIL message letting us know your comments on the
  63. utility.
  64.  
  65.   Bob Jaques  (1:350/20 12-14.4K HST)      Jim Barth   (1:350/21 12-2400)
  66.   6814 Helena Drive NE                     11544 Kevin Lane NE
  67.   Bremerton, WA  98310                     Poulsbo, WA  98370
  68.  
  69.  
  70. USAGE
  71. -----
  72.  
  73. ZIPUP will accept up to two command line arguments to process your ZIP
  74. files in the general format of:
  75.  
  76.                ZIPUP C:\PATH\ZIPFILE.ZIP C:\PATH\COMMENT.TXT
  77.  
  78. If no argument for the comment path\filename is entered, ZIPUP will
  79. automatically default to use a comment file called ZIPUP.TXT, which should
  80. be in the same directory that ZIPUP is run from.  The comment file is
  81. simply any text/ANSII file that you create with your word processor or text
  82. editor (such as DOS' EDLIN.COM) and is often used to personalize a bulletin
  83. board's downloadable files.  There is an upper size limit to the length of
  84. the comment file that can be inserted to a ZIP file by ZIPUP, which is
  85. around 65,000 bytes -- a little unfeasible in our opinion.
  86.  
  87. If there is already comments attached to the ZIP files that ZIPUP will
  88. process, ZIPUP will automatically replace those "old" comments with the
  89. comment specified in your comment file.  This is a handy fix for users who
  90. upload ZIP files to a BBS that still has comments from the BBS he may have
  91. just downloaded it from.
  92.  
  93.  
  94.  
  95.  
  96.  
  97. EXAMPLES
  98. --------
  99.  
  100. Here are some valid examples for the use of ZIPUP:
  101.  
  102. ZIPUP *.ZIP                            => 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 ZIPFILE COMMENT.TXT              => Adds the comment stored in
  108.                                           COMMENT.TXT to the specific file
  109.                                           ZIPFILE.ZIP.
  110.  
  111. ZIPUP ZIPFILE.ZIP COMMENT.TXT          => Exact same results as above
  112.                                           example.
  113.  
  114. ZIPUP E:\BBS\UPLOAD\*.ZIP C:\ZIPUP.TXT => Adds the comment stored in
  115.                                           C:\ZIPUP.TXT to all ZIP files
  116.                                           found in E:\BBS\UPLOAD\
  117.  
  118.  
  119. ERROR LEVELS
  120. ------------
  121.  
  122. Since ZIPUP was written to be easily run from a batch file, two possible
  123. ERRORLEVELS are set after the program has run.  If no errors were
  124. encountered during program execution, the ERRORLEVEL will be set to '0'.
  125. If, on the other hand, ZIPUP was unable to execute flawlessly, the returned
  126. ERRORLEVEL will be set to '1'.  After running this routine for a while, we
  127. have noticed that perhaps a couple more ERRORLEVELS would be handy to
  128. indicate specific "problems"; this will be added in a future update.
  129.  
  130. SOURCE CODE
  131. -----------
  132.  
  133. This utility came about as a result a combination of the authors wanting to
  134. know more about the structures used in ZIP files and writing a useful
  135. utility incorporating this knowledge.  Obviously, there is no secret to the
  136. algorithms used to create this utility and if you would like a copy of the
  137. 'C' source code, it can be File Requested via FIDONET as ZIPUPSRC.ZIP from
  138. either author.
  139.  
  140.  
  141.  
  142.