Short:        Locate/process files. Small & powerful!
Author:       zodiac@darkness.gun.de (Ralph Seichter)
Uploader:     zodiac darkness gun de
Type:         util/misc
Architecture: m68k-amigaos

   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.