═══ 1. Tree ═══

This package adds 2 actions which can be added to the EPM 6 Toolbar. The 
actions are: 

tree_action 
          performs a Tree command 
tree_dir_action 
          performs a Tree_dir command 

For both actions, you will be prompted for a command argument, unless an 
argument is given in the Parameters field of the Actions page of the Toolbar 
settings dialog. 

In addition, the Tree command can be entered from the editor command line.  If 
TREE.EX is not linked, it will be linked, the Tree command will be executed, 
and TREE.EX will be unlinked.  In this case, the Tree_dir command will not be 
available. 

Related information: 

Tree command 
Tree_dir command 
TreeIt command 
Alt+1 key 
Pop-up menu 
Output format 


═══ 2. Tree command ═══

This command performs a tree-search, starting at a specified directory, for 
files matching a specified mask or masks.  The output is displayed in a format 
containing more information than a DIR listing, and in a format suitable for 
sorting. 

The syntax for this command is as follows: 
 TREE [drives][path][masks] 

drives    One or more drive letters, followed by a colon.  If more than one 
          drive is specified, each drive will be searched in the order listed. 
          E.g., a:, cde:. The default is the current drive. 
path      directory sub-tree to search.  E.g., \tcpip\etc, ..\os2. The default 
          is the current directory. 
masks     one or more search strings, separated by a comma. E.g., *.c,*win*.h. 
          The default is *. 

Related information: 

Alt+1 key 
Pop-up menu 
Output format 


═══ 3. Tree_dir command ═══

This command performs a directory search for files matching a specified mask. 
The output is displayed in a format containing more information than a DIR 
listing, and in a format suitable for sorting. 

Tree_dir accepts a single file-specifier, optionally including wildcards. 

Related information: 

Alt+1 key 
Pop-up menu 
Output format 


═══ 4. Alt+1 key ═══

As in a Dir listing, the Alt+1 key can be pressed while the cursor is on an 
entry in the Tree or Tree_dir output listing.  If the cursor is on a file, that 
file will be loaded.  If the cursor is on a directory, then if the Tree_dir 
command is available, a Tree_dir will be issued for that directory; if not, a 
Dir will be issued. 


═══ 5. Pop-up menu ═══

When in a Tree or Tree_dir output listing, the default pop-up menu is changed 
to one that lets you load the current file, or sort the listing according to 
any of the fields.  (The default way to get a pop-up menu is by pressing mouse 
button 2, although this can be configured using the OS/2 System Setup.) 


═══ 6. Output format ═══

The output from the Tree and Tree_dir commands contains columns for: 

Date      The date the file was last updated, in the format yyyy-mm-dd. 

Time      The time the file was last updated, in the format hh:mm:ss. 

FileSize  The size of the file, in bytes. 

EA-size   The number of bytes of extended attributes that the file has. 

Attr.     The file's attributes: 

   A  Archive 
   D  Directory 
   S  System 
   H  Hidden 
   R  Read-only 

Full name... (% = %d%p%f ; %f = %n.%e) The fully-qualified file name.  The text 
          in parentheses is a reminder of the parameters for the TreeIt 
          command. 


═══ 7. TreeIt command ═══

This command executes any command against the files listed in a Tree or 
Tree_Dir listing.  The syntax for this command is as follows: 
 TREEIT [ /D ] command 

/D specifies that the command is to be applied to all files listed, including 
directories.  The default is that directories will be skipped. 

If a range of lines is marked in the Tree or Tree-Dir file, the command will be 
applied to those lines only, otherwise it will be applied to the entire file. 

The command can be any command which can be entered on the EPM command-line 
(EPM internal, external, or OS/2).  This means that you can use EPM's MC 
command to execute multiple commands against each file.  Substitution is 
performed against strings starting with '%', as follows.  (Assume the file is 
d:\path\name.ext.) 

%    The full file specifier, d:\path\name.ext 
%f   The filename, name.ext 
%p   The path portion of the file specifier, \path\ 
%d   The drive, d: 
%n   The name portion of the filename, name 
%e   The extension portion of the filename, ext 
%x   The full file specifier, d:\path\name.ext 
%%   Used to specify a single '%' character in the resulting command. 

If no '%' appears in the command, the default is to append the full file 
specifier to the end of the command. 

Examples: 

treeit e
         Will edit each file, loading them into
         the current edit window
treeit copy % a:\
         Will copy each file to the A drive
treeit mc ,mkdir %d%pbackup, copy % %d%pbackup
         Will copy each file to a backup directory
         below the current file's directory.


═══ 8. "Enter arguments" dialog ═══

This dialog prompts you to enter the arguments for a Tree or Tree_dir command 
(as indicated in the dialog's title bar).  Enter the desired arguments, and 
select OK to invoke the command, or select Cancel to cancel the dialog without 
executing the command. 

Related information: 

Tree command 
Tree_dir command