=============================================================================
BerkFind 1.0
Copyright (C) 1998, Jem E. Berkes <berkes@altavista.net>

Alkaid Software
http://www.alkaid.ml.org/
ftp://ftp.alkaid.ml.org/
=============================================================================
BerkFind is a very small (3 kb) DOS utility that can search a directory or an
entire drive for file(s) based on their (partial) names or on strings of text
inside the files.  BerkFind features a simple command line syntax, very fast
recursive search method, organized and informative output, and the ability to
find hidden/system files and even files cloaked with the volume attribute.

Requires: DOS 2.0 or higher and at least 128 KB of RAM.  Windows-compatible.

* FULLY FUNCTIONAL SHAREWARE; NO NAG-SCREENS, NO TIME-EXPIRY!

You are encouraged to distribute this shareware version, provided that you
make it freely available (e.g. BBS, FTP, world wide web).
=============================================================================

-----
USAGE
-----

The user performs a search by typing BERKFIND at the DOS prompt followed by
a number of options:

BERKFIND [[drive:]path] filespec ["text"] [/D] [/J] [/P] [/R] [/V]

/ Switches (any combination)
D = search for directory names too
J = jump to directory containing file   [REGISTERED VERSION ONLY]
P = pause listing after full screen     [REGISTERED VERSION ONLY]
R = restrict search to 1 level
V = include files with volume attribute

The filespec is the only required option on the command line (it may include
wildcards).  If the drive and path are omitted, searching will begin in the
root directory of the current drive.  The switches are all optional, and may
be used in any combination.

-----
NOTES
-----

The /D switch will include directories that match the file specification. For
example, to find all directories named TEMP, type: BERKFIND TEMP /D

Windows 95 and Windows NT store long filenames on FAT systems by creating
"impossible" volume attribute combinations.  If you boot to plain DOS and run
BerkFind with /V on your Win95/WinNT partition, you will see strange entries
which are the result of long filenames.  Various other programs also hide
files by setting their volume attribute.

All hidden and system files will be included in the search.  Therefore, you can
find every single file on a disk by using the command: BERKFIND *.* /D /V

Output of the search can be saved to a file using the redirection symbol. For
example, BERKFIND *.* > OUTPUT.  Do not use /J or /P when redirecting.

'Text' may be enclosed in single quotes if the double quote must be included
within the text string.  For example, BERKFIND *.TXT 'There was a "bang!".'
All text searching is case-sensitive.

You can use a period (.) for the path to refer to the current directory.

You can press CTRL+C or CTRL+BREAK followed by CTRL+C to stop the search.

ERRORLEVELs returned are 0 for success, 1 for errors.  (In other words, an
error code of 1 is returned whenever the user sees the syntax help screen.)

--------
EXAMPLES
--------

berkfind . *.* "Joe's" /r
berkfind d:\ *.tmp /d
berkfind c:\windows *.txt
berkfind *.txt "Hello"
berkfind *.* /d /v

=============================================================================
REGISTERING
=============================================================================
BerkFind is distributed as shareware, with the intention of letting you "try
before you buy".  If you like this software and would like to continue using
it beyond the 1 month trial period, you are encouraged to register it. Users
who register will receive an enhanced version of the software which has two
extra features: the /Jump and /Pause switches.

When /J is included on the command line, BerkFind will ask you each time a
file is found whether you would like to change to the directory that contains
the file.  This saves time when searching for files that are located deep in
directory structures.

/P pauses the screen after it has filled up, letting you continue by pressing
any key.  This works just like the /P switch of DOS's DIR command.

Please e-mail Jem Berkes <berkes@altavista.net> before sending your cheque to
confirm software availability.  The registered version will also be sent to 
you through e-mail.

Besides entitling you to a better version of the software, registration shows
your support for the author's work and encourages further development of this
and other shareware.

The registered version of BerkFind costs $35 U.S. for a non-commercial user.
For commercial licensing fees, contact the author at <berkes@altavista.net>.

In the United States or Canada, please send a $35 US ($50 Cdn) cheque to:

Jem Berkes
185 Waverley Street
Winnipeg, Manitoba
R3M 3K4
Canada

YOU MUST INCLUDE YOUR E-MAIL ADDRESS; OTHERWISE, YOU WILL NOT RECEIVE THE
REGISTERED VERSION OF THE SOFTWARE.

Outside of the U.S. and Canada, e-mail Jem Berkes for more information.
=============================================================================
