FFF                                     John Deurbrouck
File finding utility                        Version 1.0
-------------------------------------------------------

Purpose
-------
A file and directory-finding utility that can search
all directories on any or all drives for one or more
target filespecs. Extended wildcards, size and attribute
information, and multiple report formats are supported.

Format
------

    FFF [/a] [drive(s):] [/d|do] [/h|ho|hro] [/s]
        [/l|t|w] name(s)

Remarks
-------
The name(s) parameter may consist of multiple entries
(separated by spaces) on the same command line. Thus,
FFF *.exe *.com *.bat will find all executable files on
the current (default) drive.

In FFF, * stands for 0 to n characters, ? for one and
only one character; the period is treated specially as
an ordinary character. Thus *.* and * both mean
"all files" and *.?* restricts a listing to files that
have at least a 1-character extension. Unlike normal
DOS commands, combinations such as *C*T*.* are
permitted, facilitating finding files with a basename
that has, in this case, a C and a T in that order.

All other parameters are optional and are not sensitive
as to case or entry order. The /a switch causes FFF to
search all system drives in alphabetic order. One or
more drives may be specified, singly, in ranges, or
intermixed, by entering a drive(s): parameter. This
parameter must end with a colon, and included range(s)
of drives (e.g. c-e:) must begin with the lowest letter
drive in the group.

By default, searches begin from the root directory of
the drive(s) specified; the /s switch restricts the
search to the current subdirectory and its children.
The /d switch returns directories as well as files that
match name(s); /do lists matching directories only. The
/h switch adds hidden and system files; /ho restricts
the listing to hidden and system files; and /hro
reports hidden, system, and read-only files in addition
to normal files.

The default FFF report lists files and directories
found under their parent directories and supplies file
size, date and time, and attribute (archive, hidden,
system, read-only) information on each. File size and
allocation size totals are also supplied and a storage
efficiency percentage is calculated. The /w (wide)
switch reports entries individually, five across. The
/l (limited) switch lists number of entries and total
and allocated space. The /t (terse) switch reports
fully-qualified names only.
