"Whereis" is a utility which searches a file(name) on (hard)disk and shows
you the path to this file. Because AMIGA's power is only revealed if you've
installed a hard-disk (and AMIGA's commands are often loaded from disk
(c:-dir)), some hard-disk users (like me) will loose overview about the
stored files. If you have hundreds or thousands of subdirectories and don't
know in which of them the program "DiskSalv" was, just type in: "whereis
disksalv" and "whereis" will search through your whole active volume. You
don't have to look for with "list" or "dir" manually. All files matching
the given filename (-pattern) are displayed.

"Whereis" combines a "find that file"-function with certain list functions:
you can use it as "fnams/recurdir/mydir"[1] (or whatever that little
programs are called) to collect the filenames and give them to "ZOO" which
then can compress whole subdirectories or volumes. "Whereis" will do that
job savely for you!

** Note: "whereis" can only be started from a CLI or SHELL (sorry WB Users!).

[1] "RecurDir" or "mydir" (that's how the author (Stephen Vermeulen) named it)
was released on Fish-Disk 284. It is recursive programmed and 5516 Bytes long.


Features of "whereis":
======================

+ Case dependent/independent (switch -c).

+ Wildcards * and ? possible.

+ Abortable at any time (with CTRL-D or CTRL-C).

+ Interactive mode which allows to change your current dir.

+ Non recursive algorithm -> no problems with stack-sizes (not like LookFor or
                                                           RecurDir)
+ Works also as "fnams"/"RecurDir". Use "whereis" with pipes.
  (archives all filenames from subdirectories for "ZOO", look below)

+ Can search on any file-oriented AmigaDOS-device and in any sub-dirs.
  Can be used as a "list all".

+ Displays date and size of files if wanted.

+ some other useful options.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                 5885   10392  56.6% -lh1- a2b8 Feb 16  1991 whereis
[generic]                12159   28265  43.0% -lh1- edeb Feb 16  1991 whereis.doc
[generic]                  425     838  50.7% -lh1- dd8f Feb 16  1991 date.c
[generic]                   78     101  77.2% -lh1- 33a6 Jan 19  1990 date.h
[generic]                  218     618  35.3% -lh1- 540d Feb 18  1990 makefile
[generic]                 6408   19589  32.7% -lh1- 603d Feb 16  1991 whereis.c
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         6 files   25173   59803  42.1%            Mar 25  1994