	  >> KD v1.0 by Raffaele Spangaro (RaF) for 77-Software << 
	                     ON-FILE MANUAL                        
	 
Ŀ
  >> KD - When removing a directory is a question of time, and the   <<  
  >>      time is -------------- MONEY!!!! ------------------------  <<  


 What is KD?

 KD is a fast, pretty KILL DIR program that removes a directory, deleting
 all his subdirs.
 KD was developed to speed-up the normally removing-directories process of
 a directory with multiple subdirectories.
 
 ------------------------------  The Program! ---------------------------------
 
 KD has many switches, that allows to cancel pretty fastly a directory.
 When the time is money, KD is the best investement. 

 -------------------------------  How to Use  ---------------------------------
 KD may be used in two different ways:


 1) Use KD to delete a directory. It's very easy. For examples if you want to 
    delete a directory called KD_DIR. You will have to type 

    C:\>KD KD_DIR

    The directory will be deleted, including eventual subdirs or files.
    At the end of the removing-process KD a minimal statistics will be reported.

    If you want to exclude a directory from the removing process, you can 
    specify the switch -X.

    -- IMPORTANT! -- If you specify the switch -X the entire directory will not
    be deleted, only all subdirs or files, that are not included on the
    excluded directory.

    To exclude only the files of the directory from the removing process, you
    must specify the switch -x.In this case the directory will not be 
    deleted. At end of the process only the specified file will not be deleted.
	
 2) Use KD to delete a particular group of file. This option permits to delete
    only a particular file, as *.BAK, *._BA. In this case KD may be used as a
    pretty fast disk-clearer from the unused file.Only with a command a 
    directory or the entire disk will be cleared immediately from the unused
    files.
    For example, if you have many file such as *.BAK on the entire hard-disk in
    different directories, and you want to delete all this, you will have to
    type

    C:\>KD C: -d*.BAK 

    and immediately, the unwanted file on the entire hard-disk will be
    only a unbeatiful remember. In a moment, you will have unwanted files
    deleted and you will gain more bytes of free space.
    


  ------------------------------ The KD's switches ---------------------------
 
 -x[filename]           Excludes [filename] file(s) from the cancel process.
			[filename] syntax : Jolly admitted, to example
			-x*.ARJ, -x*.BAK, -x*.TXT, -xFILE0?0.TXT
			This option DELETE the directory wich NOT INCLUDES
			the specified file.

 -X[subdir]             Excludes [subdir] dir from the cancel process.
			[subdir] must be only the correct name of the subdir
			not the complete pathname.
			For examples, if you want to exclude the subdir 
			KD_SOURCE, and his complete path is C:\KD\KD_SOURCE
			you must type -XKD_SOURCE, and the subdir and his
			eventual subdirs will be excluded.

 -f                     Fast mode. This is a mode, that does not show the 
			progess bar with the current cancel-directory.

 -c                     Do not ask confirmation at the beginning of the removing 
			process. 

 -e[filename]           Execute [filename] before deleting. VERY important
			option. By this you can run a program before removing
			the directory.
			A pretty application. If you have a [filename] called
			BACK_UP.BAT that makes a copy of the current directory
			that will be cancel, you could create a back_up-copy
			and in a second moment delete the directory.
			SYNTAX of [filename]. Must be a file executable
			(.EXE, .COM, .BAT); No wildcards are acceptded.

 -s                     Security mode.Ask before removing a directory

 -d[filename]           Delete a particular group of files. Wildcards admitted
			This option permits to delete ONLY the selected file in 
			the specified directory 
			For examples : -d*.BAK

 -r                     Generate a final response
 
 -!                     Disable enviroment variable usage

  -------------------------------- KD'S ERROR ---------------------------------
  
  Bad XXXXXXXX argument.... :      Wrong argument syntax.For examples you have 
				   not specified a filename for the switch
				   -e.  

  -----------------------------------------------------------------------------

  -------------------------------- KD'S MESSAGE -------------------------------

  --- Are you sure you want to cancel the root directory? (y/n):
  
  You want to cancel the entire disk, with the all subdirectory.If you type
  'y' the ENTIRE DISK WILL BE CANCEL, with all files and subdirectories.
  The effect of this operations is the same of FORMAT C:.
  If you type 'n' the program will be stopped, and the disk will not be
  cleared.
 
  --- Are you sure you want to cancel the entire disk? (y/n): 

  You have selected the root directory and you have specified -d*.* as file
  specification delete.
  The ENTIRE FILE ON THE HARD-DISK WILL BE REMOVED.

  --- Directory XXXXXXXX will be killed. Are you sure? (y/n):

  If your answer is negative, the program will be stopped
  If your answer is positive, the directory will be removed.
  To toggle this message specify the switch -f.
 
  --- Oh, No!, Why have you pressed CTRL-C ....?

  You have pressed CTRL-C , the program was stopped, all files or subdirs was
  not be deleted (KILLED!).
		
  --- It's no logic, parameter ! in enviroment variable.Program stopped!      
   
  You can't specify the enviroment variable exclude parameter in the enviroment
  variable.

  --- Are you out of head, It's no logic!

  You have specified -d*.* (Delete all files) and -x*.* (Exclude all files).
  This is a non-sense command-line
			      
  ------------------------------- RETURN CODE --------------------------------- 
  
  0             Succesfully operation
  1             Internal problem
  2             Utent's Exit 
  3             Error executing a file
  4             Utent's Exit : No delete root directory
  5             Utent's Exit : No delete entire file on hard-disk

  -----------------------------------------------------------------------------


  ---------------------------- ENVIROMENT VARIABLE ----------------------------

  set KD_SW=<switches>

  All switches are admitted.
  If in the command line specify a switches that is specified in the enviroment
  variable, the enviroment variable's switches will be not processed

  For example:

    set KD_SW=-f -r -w    -x*.TXT   <- Exclude *.TXT <- This will be not processed
    KD c:\pds_uti\kd      -x*.EXE   <- Exclude *.EXE <- This will be processed
    

  Use -! to disable this options

  -----------------------------------------------------------------------------

  Please, send me a letter with your comments (goodnes, I hope) and suggestions
  at this address (add, some $8.00 or more $):

					RAFFALE SPANGARO
					Viale Rovereto 68/B
					Riva del Garda, 38066 TN, Italy
					Tel 0039-464 - 55.18.49
					FAX 0039-464 - 55.65.05

  -- Remember! -- ,
  you are free to use or distribuited this program in his originaly form with
  the associated documentation file (KD.TXT).

  You have a trial-periode of infinite days, but if you like this program,
  copy it and send me a cash of $8.00.
  PLEASE, suggestions are good accepted!

					ASK TO YOUR CONSCIENCE!!!!!!

    ----------------------------------------------------------------------
    - REMEMBER!!!! - WHEN YOU PAY ME, YOU WILL BE IN PEACE WITH YOURSELF -
    ----------------------------------------------------------------------

