+---------------------------------------------------------------------+
|                                                                     |
|               RFind Copyright (c) 1995 By Arshad Amir               |
|                                                                     |
|                                                                     |
|                          DOCUMENTATION                              |
|                                                                     |
|                                                                     |
|                                                                     |
|                                                                     |
+---------------------------------------------------------------------+
   


What is RF?

        RF is a dos file finder & processing utility (very much like unix
        find). With RF you can search files on a drive using a range of
	different attributes. And using the "-x" option you can perform
	any command on them. For example, you can
        delete all backup file (*.bak) older than 25/01/94 and bigger than 5K
        in size, using RF as follows :

        c:\>rf -r -f *.bak +s 5 -d 25/01/94 -x "del"

	You can also intelligently combine the options to do more complex
	tasks. For example, using the following command you can delete all
        files bigger than 5K and smaller than 10K.

	c:\>rf -r -f *.* +s 5 -s 10

How do i use RF?

        rf [options]

        options :

        -f <pattern>

        RF will find files which matches the <pattern>.

        -r

        RF will search all sub directories recursively.

        +d dd/mm/yy

        RF will find files recent than dd/mm/yy.

        -d dd/mm/yy

        RF will find files older than dd/mm/yy.

        +s n

        RF will find files bigger than <n> KBytes.

        -s n

        RF will find files smaller than <n> KBytes.

        -x "command"

        RF will perform "command" on each matching file. Dont forget quotes
        and pls note that RF appends the matching filename to the command. See
        below for more details.

        -i

        RF will prompt user before performing <command> on files.


How does -x option works?

        Using -x option you can tell RF to execute a single word
        command with matching filename as its argument.
        eg.__ rf -f *.old -x "del" __ means del all *.old files. This
        format is quite flexible. Suppose you wanted to archive all the
        MS Word files (*.doc). Create a batch file (tryme.bat) as follows:

                @pkzip \wrdfiles %1

        and put it somewhere in the PATH. Then run

                rf -r -f *.doc -x "tryme"


        PS: Author recommends that you use "-i" option for
            drastic processing like recursive delete etc.

Disclaimer
----------

RFind or RF is aimed at making routine disk management easier. Author
of this utility has not performed exhaustive testing. Therefore, by
using it you agree to do so at your own responsibility.

LICENSE
-------

RF is a public domain software. Distribute is freely.

Contact
-------
source code available on request. bugs and suggesstions to
-arshad amir email -> u9002456@rabble.uow.edu.au
