

                               Zip Clean! v1.1
                                ZIPCLN11.ZIP
                     Copyright (c) 1995 Thomas J. Smith
                        For the latest version, call
                      The Last Call BBS! (313) 295-6284
                    or FREQ it from 1:2410/903 - ZIPCLEAN


͸
   This program is distributed as Freeware. Meaning that you may keep it   
and use it for as long as you wish without having to pay any fees or       
registration. You may distibute this program to others as long as all files
are intact and unmodified including all text files. You are encouraged to  
pass this program around and upload it to every BBS you call!              
;






͸
 CONTENTS                                                                  
;
  What is Zip Clean?......................................................1
  How it Works............................................................2
  Files Included..........................................................3
  Using Zip Clean.........................................................4
  Contacting The Author...................................................5
  Disclaimer (legal stuff <G>)............................................6



͸
 What is Zip Clean?                                                      1 
;

    Zip Clean is a useful program if you keep .ZIP files around anywhere, be
 it on your hard drive or on floppys. Zip Clean uses a text file (included)
 that contains a list of file names of files that you do not want in your
 .ZIP files. There are many SysOps and others alike, who cannot resist the
 urge to put their own little ad into every .ZIP file they come across, and
 there are those of us who do not care to read or execute these files, as
 they are basically, totally useless and sometimes space consuming! A high
 number of these files use file names that contain high ASCII characters,
 $ô S ôs These types of files can only be erased by either leaving
 them as the only files left in a directory and then deleting the directory,
 or holding down the ALT key, looking up the ASCII character in your DOS
 manual, and typing in the numbers that represent each character, one at a
 time! Or by using the sometimes frightening DEL *.* command! This can be
 very tedious, and it is no fun at all! So here it is, the program you've
 been waiting for (only you just did'nt know it <G>)! Zip Clean will erase
 these files from your .ZIP files, and will do it quite fast too.



͸
 How it Works                                                            2 
;

    I have included a file called UNWANTED.LST, which contains some popular
 file names of unwanted files contained in .ZIP files. You may edit this file
 to reflect whatever files you want removed from your .ZIP files, or create
 your own and name it UNWANTED.LST. It contains only one file name per line,
 and can be as long as you can make it! When you execute Zip Clean, it reads
 the UNWANTED.LST file, and searches the .ZIP file(s) you chose on the
 command line for these files, and if they exist in the specified .ZIP
 file(s), then they will be erased from the .ZIP file(s). It can be used on
 one file at a time, or all .ZIP files in a directory in one shot by using
 the *.* wildcard. Wildcards can be used on the comman line now, starting
 with v1.1. For example, to clean all .ZIP files starting with D in the
 current directory, you would type, ZIPCLEAN D*.*, or ZIPCLEAN D*.ZIP.

    Wildcards in the UNWANTED.LST file, are currently not supported. So for
 every file that you want deleted from your .ZIP files, you will need the
 full name of the file in the UNWANTED.LST file. I will add this support
 sometime in the future.



͸
 Files Included                                                          3 
;

    Included with your copy of ZIPCLN11.ZIP, should be the following files,

 ZIPCLEAN.EXE > Main Program.

 UNWANTED.LST > Text file containing names of popular unwanted files. Used
                   by ZIPCLEAN.EXE every time it is run.

 ZIPCLEAN.TXT > The documentation you are reading now.

 README.1ST   > Text file you should have read first.

 WHATSNEW.TXT > Text file describing recent changes & additions.

 FREQ_IT.TXT  > List of FIDO Net FREQ'able programs from Thomas J. Smith.

 FILE_ID.DIZ  > Description file for BBS's.



͸
 Using Zip Clean                                                         4 
;

    First of all, have a look at the UNWANTED.LST file, and edit it to your
 likings if you wish. This is a plain ASCII text file listing all of the
 files that you want erased from your .ZIP files. Load it in any text editor
 such as DOS's EDIT, and look it over. Or you can erase this one, and create
 your own. Just make sure it is named UNWANTED.LST, and resides in your path.

    Next, move the two files, ZIPCLEAN.EXE and UNWANTED.LST to a directory
 that is in your path. This can be any directory that is stated in your
 AUTOEXEC.BAT file after the statement, PATH=. This way, you can call Zip
 Clean from any directory. This is how the program was written to work.

    Having done that, you can now start using the program. Change to a
 directory containing .ZIP files that you would like to "clean" and type,
 ZIPCLEAN FILENAME.ZIP to clean one particular .ZIP file (the .ZIP extension
 may be omitted if you desire), or ZIPCLEAN *.* to clean all .ZIP files in
 the current directory. If you use the *.* command, it does'nt matter if
 there are any other files with different file name extensions in your
 current directory, Zip Clean will ignore them and work only with the .ZIP
 files in that directory. As of v1.1, wildcards are now supported on the
 command line. For example, to clean all files starting with D, you could
 type, ZIPCLEAN D*.*, or ZIPCLEAN D*.ZIP, etc.

    When cleaning a .ZIP file that has been converted to an .EXE file using
 ZIP2EXE.EXE, then you must specify the .EXE extension on the command line
 when giving the file name in order for Zip Clean to recognize it. For
 example, to clean a self extracting .ZIP file named GAMEPACK.EXE, type,
 ZIPCLEAN GAMEPACK.EXE. This will not work however, on multiple .ZIP files
 converted to .EXE format. Only one at a time <sorry> :(


  Basic Usage
 -------------
  ZIPCLEAN FileName.Zip [Options]

    The command line option to have Zip Clean use an alternate list of
 unwanted files has been changed, and another option added. They are as
 listed below.

 NOTE: These options MUST be used AFTER the first command line parameter,
       which is the name of the .ZIP file(s) to clean. They can be used
       as one, together in any order, or not at all! :)

 /F:Files.Lst - Where /F: informs Zip Clean to read a different file list
                other than UNWANTED.LST for unwanted files, and FILES.LST
                specifies the name of this list. If the list is in a
                directory other than your current directory, then the full
                path and file name must be specified after the /F:

 /L:LogFile.Txt - Where /L: informs Zip Clean to write its work to a log file
                  specified by LOGFILE.TXT. This will be a log file
                  containing names of all .ZIP files processed, and if they
                  were cleaned or not, and if so, the names of the files
                  deleted from the .ZIP file(s). If the log file already
                  exists, then it will be added to, if it does not exist,
                  then it will be created.



͸
 Contacting The Author                                                   5 
;

    If you have a comment, question, or suggestion, you may call my BBS,
 The Last Call BBS! (313) 295-6284 and [P]age SysOp, or leave a [C]omment to
 SysOp, or crash mail me through FIDO at 1:2410/903. I can also be contacted
 by Internet E-Mail at the following address,
 Tom.Smith%wland@ack.mi.org

 If you really wish, you can contact me by snail mail and I will respond
 promptly. The address is,
                             The Last Call BBS!
                             26910 Beverly
                             Taylor, MI 48180



͸
 Disclaimer (legal stuff <G>)                                            6 
;

    This program may be freely distributed. You are encouraged to share this
 program with others. You may keep This program for as long as you like and
 not have to pay a penny. You may pass it out to others, upload it to BBS's,
 and make it available for download on your BBS (where applicable).

    There are no warranties of any kind implied with this program. Use of
 this program is the sole responsibility of the user. The author of this
 program claims no responsibility whatsoever for damages of any kind related
 to the use of this program. You use it at your own risk.



 END OF ZIPCLEAN.TXT ͵
