Topic       : User Manual for TeraDesk
Author      : Wout Klaren, Henk Robbers, Djordje Vukovic
Version     : February 2017
Subject     : Documentation/Utilities
Nodes       : 87
Index Size  : 2746
HCP-Version : 3
Compiled on : Atari
@charset    : atarist
@lang       : en
@default    : Main
@help       : 
@options    : -i -t4 +z
@width      : 75
View Ref-File
   Contents
      Menus and Dialogs
         Menu title: File

4.2.5   Search...                                             TeraDesk

When this menu item is selected, a dialog  appears  in  which the name
pattern (name or name mask) to be searched for  in the selected files,
folders  and / or disk volumes is  specified. If no selection is made,
the search  will be  active  in the  top directory  window.  If a text
window is  topped  and  a string  is specified  for search, it will be
searched for in the file displayed in this text window.

A file/folder name  or name pattern (mask)  must always be  specified.
If it is not specified, search will not commence.

Date and size limits are optional; if left blank, TeraDesk will ignore
them.

String  to be  searched for  is optional.  If left blank, Tera Desktop
will only search  for files and folders  having names  that  match the
name  pattern  mask.  If any string  is specified,  Tera Desktop  will
search for it in the files that match the name pattern.

If a string is specified, the search can be modified  by selecting the
option to ignore character case when matching strings (this option may
not work  correctly  for 'national' characters with ASCII codes in the
128-255 range).

By default any search will involve all subdirectories of  the selected
directory or volume.  This can be modified  by selecting the option to
skip search in subfolders.

If either the size range or the string is specified, search is limited
to files only  (i.e. any directory names  matching the pattern will be
ignored).

If a match  is  found  the  Info...  dialog  is  opened   showing  the
specification of  the  found  object.  If  a  search  string  has been
entered, file contents surrounding the found string are displayed;  to
save  space, the  string itself  is replaced by [...]  so that more of
the  text preceding  and following  the string can be displayed.  Note
that some  characters  which  would  corrupt  the  formatting   of the
displayed  text  are replaced  by a substitute -  the <DEL> character,
which in most fonts is represented by a small triangle.

Note that each file searched for strings is first completely read into
memory.  Therefore, searching  for strings in  large files  may not be
possible,  depending on the amount of free memory.  If a search string
is not  specified,  search  will  involve  only file and folder names,
without actually reading any files, and memory will not be a limit.

Search operation can be interrupted by pressing the [Esc] key.

An installed application  can be set  to perform  the search function.
The  application will  completely replace the built-in search function
and its dialog in TeraDesk. See Set applications...