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: View

4.3.7  Set mask...                                            TeraDesk

With this  menu item, the user  select  which files  are shown  in the
current (top) directory  window.  A dialog box is displayed into which
you can either type a name mask (a pattern for object names which will
become visible in the window) or select a mask from a predefined list.

Double  clicking  on  a mask  in  the  list  has  the double effect of
selecting the mask and exiting the box as if you selected 'OK'.

It  is  also  possible  to delete the mask  that is selected,  edit an
existing mask, or add a new one to the list. See The listbox dialog.

The  selected  mask  ONLY  applies  to  the directory window  that was
current (topped) when this item was selected.  See also  Conventions.

Some characters have special meanings in name masks and enable them to
be used for ranges of object names.  Those characters (sometimes named
'wildcards') are:

   *                        - any string of characters
   ?                        - any single character
   !<char>                  - any single character but <char>
   [<char1><char2><...?>]   - any one of the <char1>, <char2>...

A complete filename can be specified  for the mask as well,  either by
entering it manually, or by selecting a name in a directory window and
then opening this dialog.

It is also possible to specify an exclusion mask: if a tilde character
'~' is prepended  to  a mask,  all  names  that  do  -not-  match  the
remaining of the mask string will be shown.

User should beware that, on a slow machine,  specifying a very complex
name mask may slow the opening of directories considerably. Also, some
masks do not make sense and  can not be  understood by TeraDesk:  e.g.
one should not use '!...' or '[...]' between '*' and another wildcard.

If a mask is not set for some  directory window, Tera Desktop will use
the default mask. In single-TOS,  the default catch-all mask is '*.*';
in multi-tasking environments with looser restrictions  on names it is
just '*'.  An explicitly set mask  for a directory window can be reset
to default  by clearing  the  editable  field  in the dialog  and then
clicking 'OK'.

In single-TOS, only the '*' and '?' wildcards are legal. However, Tera
Desktop permits the use of  '~', '!...' and '[...]' in single-TOS, but
within the constraint  that the 8+3  filename structure  of single-TOS
must be obeyed.

Besides the name mask, one can use the autoselector in order to locate
items in a directory window.  See also: Conventions  Directory windows

Alongside name masks,  four other  file masking options  relevant only
for Directory windows can be set:

     Hidden              show hidden files
     System              show system files
     Subfolders          show subfolders
     Parent              show the '..' (parent) virtual folder

These selections are global, i.e. they apply to ALL Directory windows.

It should be noted that, if  Parent  option is set,  the Closer widget
will always  completely close any directory window.  If this option is
disabled, the Closer widget will, if a window displays the contents of
a (sub)folder,  switch the  displayed directory to  that of the parent
folder.