I wrote 'find' because I needed a tool to find files (obviously :) which
match a given name pattern. 'find' is able to search multiple directories,
including all subdirectories, the current directory and its subdirs, or the
current CLI command path only. The output can be formatted in a way which
tries to imitate 'List LFORMAT' behaviour, and you can make 'find' create
shell scripts for you and execute them on the fly.

   Please note that 'find' is pure, you can make it resident. As it is less
than 3 KB in size, this is recommended. Check the executable by using the
List command (you should see output like the following line) and modify the
file protection bits if necessary:

        find   2760 --p-rwed 17-Jan-96 16:45:55

   Requires 'dos.library' V36 (OS 2.0) or better.

[...]

USAGE EXAMPLES

   Locate all C source files on partition DH1:
   -> find #?.c dh1:

   Find all Icons in the current directory and all its subdirs, but
   don't display the ".info" suffix.
   -> find #?.info lformat %m

   Print file name stems and extensions as a formatted table.
   -> find #? RAM: lformat "%-20N|%3.3e"

   Get rid of all files with the prefix "foo" on some partitions, but
   don't go deeper than three subdirectory levels while scanning.
   -> find foo#? sys: dh2: bozo: depth=3 lformat="delete %p%n" exec

   Find 'Type' in the command path.
   -> find Type path

   Find all occurences of 'bar' in the command path.
   -> find bar full

   I hope that these few examples show some of the potential of 'find'. The
possibility to create shell scripts and have them executed without further
interaction is certainly very useful for many tasks.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                 1729    2760  62.6% -lh5- b257 Jan 17  1996 find
[generic]                 5938    9344  63.5% -lh5- 5f38 Jan 17  1996 find.doc
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         2 files    7667   12104  63.3%            Jan 23  1996