


			  ͻ    
			           RM.EXE         
			      by Teik Leong Tan              
			  ͼ




Documentation:
==============
This program removes/deletes files from the current directory.
How is this program better than MS-DOS DEL (or ERASE) or DELTREE?

  [1]  RM.EXE is about 83% faster than DELTREE on a simple directory
       removal, containing 64 files and 40 directories.  
       RM.EXE is almost three times the speed of DELTREE on removing 
       a directory with 166 files (just a random test).

  [2]  RM can delete multiple file pattern using one command, whereas
       MS-DOS can only delete one file pattern at a time.
       For instance,
		     RM a:car*.* c:\dos\*.txt ..\*.pas c:\dir

  [3]  RM can delete protected files;  such as files with attributes like
       hidden, readonly, or system.  In MS-DOS, you'd first have to use 
       ATTRIB to set the file(s) to an unprotected mode before you could
       delete them.  With RM.EXE, you can directly delete the protected 
       files.

  [4]  RM provides you with a summary report of what has been done.
       For instance, you will be notified how many files and directories
       have been deleted.

  [5]  RM will show you the progress of deletion, whereas MS-DOS just leave
       you hanging and guessing what is going on inside the computer.

  [6]  RM has the prompt feature (/P) that is available only in MS-DOS 
       Version 4.0 and above.  With the prompt feature, the program will
       prompt you for verification of a deletion.

Above are only a few reasons why RM is better than DOS DEL or DELTREE.
Just try out RM, and believe me, you will fall in love with the program.


RM Options:
===========

Default settings:
  - The program is not quiet.
  - The program will not prompt the user for deletion confirmation.
  - Prompt the user when a directory is encountered.
  - Prompt the user when a protected file is encountered.

/Q  Quiet mode.
    This mode suppresses the display of the file deletion process.
    It only displays the title, and the count of the number of files deleted.

/P  Prompt mode.
    RM will prompt before a file deletion.

/F  Forced deletion mode.
    This mode will delete all files whether or not the files are protected.
    If this option is specified, you will not be prompted for protected-
    file removal.  The program will just go ahead and remove any protected
    files it may encounter.

/F- Never Force delete.
    This mode will assume that you never ever want to delete protected files.
    Protected files will just be ignored.

/D  Include directories in deletion.
    The program will not prompt the user when a directory entry is 
    encountered.  It will go ahead and delete the directory.

/D- Exclude directories in deletion.
    The program will ignore all directories encountered and proceed with
    other entries.



Example:
========

RM .                     - This is a special feature of RM
			 - Removes the current directory and all its
			   subdirectories
			 - Option "/D" is assumed
			 - Especially useful when testing out shareware
			   programs

RM /D C:\WIN\*.*         - Removes all entries (files or directories) in
			   C:\WIN directory
			 - Prompt only when there are protected files in 
			   the C:\WIN directory 

RM /D- C:\WIN\*.*        - Removes only file entries 
			 - Do not prompt for directory removal

RM /F C:\WIN\*.*         - Removes all file entries -- protected or not

RM /F- C:\WIN\*.*        - Removes only normal file entries
			 - Leave protected file entries intact  

RM /F /D C:\WIN\*.*      - Removes ALL entries in C:\WIN directory
			 - Computer will not prompt for anything

RM /F- /D- C:\WIN\*.*    - Removes only normal files
			 - Ignore all directories and protected files

RM /D C:\WIN             Assuming that C:\WIN is a directory:
			 - Computer will remove the entire directory
			   without prompting for anything

RM /P C:\DOS\*.TXT A:*.PAS ..\*.OLD      - Removes several patterns through
					   one command line
					 - Computer will prompt user for
					   each of the entries found



That's all you need to know.
Enjoy using the program and have fun!

Author,
Teik Leong Tan
May 31, 1994
