home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / ZIPS13.ZIP / ZIPSTAMP.DOC < prev    next >
Text File  |  1992-06-30  |  8KB  |  156 lines
  1.  
  2.     ZIPSTAMP.DOC                                          Page:1
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                               Zip Stamp Version 1.3
  10.                   A Utility For Adding Comments To Zip Archives
  11.            Copyright (C) 1992 Lightning Software, All Rights Reserved
  12.                        Written And Coded By Robert L. Folmer
  13.  
  14.           ***Bear Cat BBS Home Of Lightning Software (404) 739-1216***
  15.  
  16.           Warranty
  17.           ========
  18.           Zip Stamp 1.3 is distributed without warranty. In no event
  19.           will Lightning Software be liable to you for any damages from
  20.           running this program. Including any loss of profits, lost
  21.           savings, or other incidental or consequential damages arising
  22.           out of your use of or inability to use the program, even if
  23.           Lightning Software or a authorized representative has been
  24.           advised of the possibility of such damages.
  25.           Lightning Software will not be liable for any such claim by
  26.           any other party. All risk associated with using this program
  27.           are the complete responsibility of the user.
  28.  
  29.           Introduction
  30.           ============
  31.           Zip Stamp is a very small and compact program, it allows you to
  32.           comment your zip files, with a simple 1 line comment up to a
  33.           comment size of 20K! It is great for BBS system operators as well
  34.           as it allows you to automatically via a batch file, put a comment
  35.           into a recently uploaded zip file. This is great for advertisements
  36.           and more! It's quick and simple design makes it one of the first
  37.           choices in zip file commenting programs.
  38.  
  39.           Installation
  40.           ============
  41.           Installing Zip Stamp is an extremely easy procedure. It can be
  42.           installed and run from a floppy diskette or a hard disk drive.
  43.           However make sure that where you install it, PKZIP.EXE will be
  44.           accessible either via a PATH statement in your AUTOEXEC.BAT file
  45.           or in the same directory you run the program from. To install
  46.           Zip Stamp on a floppy diskette, simply format a diskette to hold
  47.           the Zip Stamp files, then simply uncompress the archive to the
  48.           newly created diskette. To install Zip Stamp on a system equiped
  49.           with a hard disk drive, simply create a directory to hold all
  50.           Zip Stamp files, then simply uncompress the archive into the newly
  51.           created directory. Now before running Zip Stamp you should use your
  52.           favorite ASCII text editor to edit the file ZIPSTAMP.DAT. This file
  53.           is a straight ASCII text file that contains the comment you would
  54.           like Zip Stamp to add to your zip files. You may edit the one
  55.           supplied or create your own. You should note however, that the
  56.           first line should be left blank, this insures that your text will
  57.           be centered properly. Although it is possible to add an ANSI
  58.           comment using Zip Stamp, it is not recommended as to be able to view
  59.           an ANSI comment you will have to add the -q option while unzipping
  60.  
  61.  
  62.     ZIPSTAMP.DOC                                          Page:2
  63.  
  64.  
  65.  
  66.           the file, therefore it is best to use a straight ASCII text file.
  67.           That's all there is to installing Zip Stamp! Now to run the program
  68.           simply enter the following command at the DOS prompt.....
  69.  
  70.           ZIPSTAMP [Drive][Full path and name of zip file to be commented]
  71.  
  72.                                        Example.....
  73.  
  74.                             ZIPSTAMP C:\FILES\ZIPSTAMP.ZIP
  75.  
  76.           The above example will comment the file ZIPSTAMP.ZIP located in the
  77.           C:\FILES directory with the ZIPSTAMP.DAT comment.
  78.  
  79.           IMPORTANT! ZIPSTAMP.DAT Must be located in the same directory
  80.           as ZIPSTAMP.EXE or the program will abort!
  81.  
  82.           You should note that by typing ZIPSTAMP on the command line without
  83.           any drive or path specified will bring up a help screen for a quick
  84.           reference to using Zip Stamp.
  85.  
  86.           Using Zip Stamp On A BBS
  87.           ========================
  88.           Using Zip Stamp on a BBS to comment newly uploaded zip files is one
  89.           of the most used aspects of Zip Stamp. Setting up Zip Stamp on a BBS
  90.           is quite easy. First your BBS software must be able to call a batch
  91.           file when an upload completes passing the full path and name of the
  92.           uploaded file to Zip Stamp. This should not be a problem since most
  93.           systems use batch files for testing and scanning a uploaded file
  94.           anyway. A good example of one system that supports the use of a
  95.           upload batch file is TriBBS. Below is an example of a UPLOAD.BAT
  96.           batch file for TriBBS, with most systems the batch file will not
  97.           need much modification from that shown in order to operate properly.
  98.           Simply modify the following batch file for your BBS software.....
  99.  
  100.           ECHO OFF - Sets the DOS echo feature to off
  101.           CD\TRIBBS\ZIPSTAMP - Changes to the ZIPSTAMP directory
  102.           ZIPSTAMP %1 - Runs Zip Stamp and passess the full path and name of
  103.                         the uploaded file to Zip Stamp.
  104.           CD\TRIBBS - Changes back to the TRIBBS directory
  105.  
  106.           Notice that the batch file above does not include a command to reload
  107.           the bulletin board software. This is because TriBBS does not exit
  108.           from memory before running UPLOAD.BAT, so therefore when Zip Stamp
  109.           drops back to the command line, TriBBS will then take control. Some
  110.           software however may require the use of a command to reload the
  111.           system, please see your BBS software manual for information on
  112.           calling batch files.
  113.  
  114.           Zip Stamp cannot comment files other than zip files, note that it is
  115.           OK if your software calls Zip Stamp for a non zip file. Zip Stamp
  116.           will simply display the message "Archive Specified Cannot Be
  117.           Processed By Zip Stamp Or Error In Archive." this message will be
  118.           displayed if the file specified was not a zip file, or if there is an
  119.           error in the zip file. Zip Stamp will simply drop back to the command
  120.  
  121.  
  122.     ZIPSTAMP.DOC                                          Page:3
  123.  
  124.  
  125.  
  126.           line and return to the system as normal.
  127.  
  128.           Registration
  129.           ============
  130.           Zip Stamp 1.3 is being distributed under the shareware concept,
  131.           you are free to use this product for a period of 30 days after
  132.           which you must either register the program or discontinue it's use.
  133.           Registration is only $10.00, registering Zip Stamp will get rid of
  134.           the unregistered notices and delays contained in the program. When
  135.           you register Zip Stamp you will receive a registered copy of the
  136.           software on your choice of 3 1/2" or 5 1/4" disk. As well as the
  137.           latest version and lifetime support. To register your copy please
  138.           complete the included form (REGISTER.FRM) and return it to the
  139.           address on the form.
  140.  
  141.           Questions And Or Comments
  142.           =========================
  143.           If you have questions or comments about this or any other
  144.           Lightning Software product, please write to the address below
  145.           or call the Lightning Software support BBS (Bear Cat BBS)
  146.           at (404) 739-1216 24 hours a day.
  147.  
  148.  
  149.                                    Lightning Software
  150.                                       P.O. Box 177
  151.                                  Lithia Springs, Ga 30057
  152.  
  153.  
  154.  
  155.  
  156.