Help System (web edition)

WHERE <filespec>                                             / K.Vehkalahti
searches files from the disk(s) by their name. By default the found files
are presented as a file list in another desktop operation, DD (see DD?).
The default behaviour can be modified by various specifications, which are
described on the following pages.

The <filespec> can contain several disks and wildcards in the filename.
If any disk(s) without directories are given, the search starts from the
root directory of each disk:
    WHERE CDE:*.TMP

If the disk(s) are omitted (giving nothing but the filename), only the
current directory tree is searched:
    WHERE *.EDT

Scanning of the files is interrupted by pressing '.' (full stop).
WHERE can also be used from DD by the Where key (W).

There is another desktop operation (see SEARCH?), which searches the
given words inside the files.

Specifications of WHERE:

  WHERE=<rules>      Modifies the search in various ways. <rules> may be
                     any combination of following: (separated by commas)
                      SUBDIRS -> scan also the subdirectories [1]
                        FIRST -> exit straight after first match
                                 (Use of TUTSTACK specification (see DD?)
                                 may be useful, see also sucro PS-PDF)
                           DD -> start DD with the files that matched [1]
                              [1]: (default behaviour, c.f. SEARCH)

  OUTFILE=<file>     The full pathnames of the found files are written into 
                     the given file, which is erased. 

The specifications SINCE, BEFORE, MINBYTES and MAXBYTES (see: DD?) can also
be used with WHERE, as well as any other specifications of DD.

  D = More information on desktop operations