
                             SHAREWARE EZFIND V1.5
                             ---------------------

Legal stuff:
------------

Before I go on, I want to say that the software is distributed as is.  I,
the author, am NOT responsible for any damage(s) that are caused from the
use of this software.  How you use it is up to you.

Any trademark names mentioned in this document belong to their respective
manufacturers, and I have no connection with them.

Introduction:
-------------
Over the years of programming, I have decided to write a directory and file
utility that is useful for software developers and computer users.  Let me
introduce you EZFIND, the directory and file utility that lets the users
manipulate files and/or directories via *ANY* specified runtime commands,
e.g., "dir", "del", etc.  That's right!  It finds the files based on the
specified conditions and operate on them!

To go over the features of EZFIND right now would rob the fun away from the
users, because EZFIND supports online hypertext help.  And I would recommend
that the user should browse through all the options before starting using it.

EZFIND is distributed as a SHAREWARE, and, thus, please register if you find
that EZFIND is useful.  When registered, you will receive a complete version.

Please feel free to distribute the shareware version of EZFIND IN ITS
ORGINAL ENTIRETY of the shareware package without any modifcation.

The software is aimed for developers and system admins; however, a typical
DOS user can use it without any problem because (1) it basically create
processes to execute the specified command(s), just like how one would enter
a command at the DOS prompt, and (2) it's very well documented, IMHO.

What's new in V1.5?
-------------------
*Support internal 'del', 'dir', 'rmdir' commands to avoid
spawning out processes.  The internal 'dir' command works both for the
options -fcmd and -dcmd.  However, when specified for the -dcmd option,
it will act exactly as if one would specified in DOS.

*When option -fcmd is not specified, the file(s) with their complete paths
are printed out, useful to simply search for a specific file or a certain
file type on disk.

*Subdirectory names are printed out only if the -dcmd option is supplied with
the command 'list', that is, '-dcmd list'.

*Provided '-se' option so that the user can terminate EZFIND before
EZFIND processes on each file found.  This is provided because once
EZFIND passes control to a command interpreter, e.g., COMMAND.COM, there
is no way to break out EZFIND!  When you use this option, EZFIND will
prompt you to see if you want to quit EZFIND each time it has found to
file to operate on!

*Better documentation in hypertext and this file.  I added a section in the
hypertext help screen to list all possible error messages reported by
EZFIND, and what to do when you encounter them.   As much as I tried to make
the documentation as its best, I am sure there is room for improment, and I
apologize for bad usage of English from my previous release...My brain is at
high speed but my fingers aren't!!??

*For the shareware version, you now have 21-day trial period, starting from
the day that you first run the software *OR* 50 trial runs, whichever comes
first.  EZFIND will refuse to run after the 21-day trial period or when you
have used up the 50 trial runs.  When that happens, please register...Or be
thrifty and re-install the shareware version.  Remember that if you register,
you will get a full version with more features and WITHOUT the shareware
"hassles" :-)

How to install the program:
---------------------------
The program is distributed as a ZIP file and is named as EZFIND15.ZIP.  To
install EZFIND, simply copy the ZIP into the directory that you want EZFIND
to reside.  Then using 'pkunzip' (tm) to unzip the file.  The below files
will be created in the current directory.

Files                Descriptions
-----                ------------
EZFIND.EXE           -This is the EZFIND utility executable.
HTML.EXE             -This is the hypertext help that provides online
                     help.
README.TXT           -This file.
ORDER.FRM            -The ordering form.

Make sure that your PATH environment points to the directory where EZFIND
resides.

System requirement:
-------------------

You will need the followings on your computer to run EZFIND:

(1) MS-DOS V2.0 or later.  Or any DOS version whose COMMAND.COM supports
the /C option.  (You can check by typing 'COMMAND.COM /?'.)

(2) At least 57KB of RAM to run EZFIND.  If you specified the '-r' option,
then at least 67KB is needed because of the secondary stack used by EZFIND.
Please also read about the '-memsize' option.  More memory is needed when
you give a bigger number to the '-memsize' option.  When going into hypertext
help, you will need at least 200KB of RAM.  (The 200KB is because of fancy
hypertext help, windows and mouse interface, etc.)

How to run the program:
-----------------------

After you have installed the software, the best way to use the software is
to see what it offers.  Do this by getting into the hypertext help.  Type
'EZFIND -h' and you will be in the hypertext help screen.  In fact, I suggest
that you take a break now and experience with EZFIND before reading on.  It
would be helpful to you.

Once you have used EZFIND, you can always list EZFIND's options by simply
type 'EZFIND'.

When in doubt, always use EZFIND without supplying any runtime command
to it.  This way, it will simply print out the files it found, which it
would operate on had a runtime command had been specified.

Performance
-----------

Because EZFIND spawn out process to manipulate the files or directories
found, the time it takes to manipulate a file or directory depends on
the runtime command that the user supplied.    One thing that I like to
mention is that if you want to simply list files and/or directory names
on your hard disk, for example, it's best NOT to supply any runtime command.
That's because by default, EZFIND will list the file and/or directory names
that it found based on the conditions you gave it.  In V1.5, you can get
a more detailed listing of the files found by giving the 'dir' command to
the '-fcmd' option.  Again, to list the directory names found, issue the 'list'
command for the '-dcmd' option; otherwise, no directory names will be
printed.

To register
-----------

To register, please send $15.00 + $2.50 S/H ($5.00 for oversea) in
US funds to the below address:

Sang Le
4474 Yerba Buena Ave.
San Jose, CA 95121

Or print the file ORDER.FRM and fill it out.  Thanks.
(To register EZFIND, simply type 'EZFIND -order > ORDER.FRM'.  Print
ORDER.FRM and fill it out, with a check or money order enclosed, of course :-)

How to contact me
-----------------

My name is Sang Le & my email address is sangle@inow.com.  Feel free to
email me for whatever reasons: compliments, complains (be gentle),
bugs (OUCH!!!), and/or suggestions.  I cannot promise that I will answer all
your emails, and, if I do, I cannot promise to answer in a fast manner.
(Let's hope that there won't be tons of emails for me :-)  If you have
questions, please get into the hypertext help screen first.  It's likely that
your question(s) will be answered from the help screen;  otherwise, drop me a
line.  BTW, support is given only to registered users.

Well, enjoy!  And please do register!

Thank you for using EZFIND.
