home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / epmhlp.zip / TREE.HLP (.txt) < prev   
OS/2 Help File  |  1995-04-18  |  7KB  |  166 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Tree ΓòÉΓòÉΓòÉ
  3.  
  4. This package adds 2 actions which can be added to the EPM 6 Toolbar. The 
  5. actions are: 
  6.  
  7. tree_action 
  8.           performs a Tree command 
  9. tree_dir_action 
  10.           performs a Tree_dir command 
  11.  
  12. For both actions, you will be prompted for a command argument, unless an 
  13. argument is given in the Parameters field of the Actions page of the Toolbar 
  14. settings dialog. 
  15.  
  16. In addition, the Tree command can be entered from the editor command line.  If 
  17. TREE.EX is not linked, it will be linked, the Tree command will be executed, 
  18. and TREE.EX will be unlinked.  In this case, the Tree_dir command will not be 
  19. available. 
  20.  
  21. Related information: 
  22.  
  23. Tree command 
  24. Tree_dir command 
  25. TreeIt command 
  26. Alt+1 key 
  27. Pop-up menu 
  28. Output format 
  29.  
  30.  
  31. ΓòÉΓòÉΓòÉ 2. Tree command ΓòÉΓòÉΓòÉ
  32.  
  33. This command performs a tree-search, starting at a specified directory, for 
  34. files matching a specified mask or masks.  The output is displayed in a format 
  35. containing more information than a DIR listing, and in a format suitable for 
  36. sorting. 
  37.  
  38. The syntax for this command is as follows: 
  39.  TREE [drives][path][masks] 
  40.  
  41. drives    One or more drive letters, followed by a colon.  If more than one 
  42.           drive is specified, each drive will be searched in the order listed. 
  43.           E.g., a:, cde:. The default is the current drive. 
  44. path      directory sub-tree to search.  E.g., \tcpip\etc, ..\os2. The default 
  45.           is the current directory. 
  46. masks     one or more search strings, separated by a comma. E.g., *.c,*win*.h. 
  47.           The default is *. 
  48.  
  49. Related information: 
  50.  
  51. Alt+1 key 
  52. Pop-up menu 
  53. Output format 
  54.  
  55.  
  56. ΓòÉΓòÉΓòÉ 3. Tree_dir command ΓòÉΓòÉΓòÉ
  57.  
  58. This command performs a directory search for files matching a specified mask. 
  59. The output is displayed in a format containing more information than a DIR 
  60. listing, and in a format suitable for sorting. 
  61.  
  62. Tree_dir accepts a single file-specifier, optionally including wildcards. 
  63.  
  64. Related information: 
  65.  
  66. Alt+1 key 
  67. Pop-up menu 
  68. Output format 
  69.  
  70.  
  71. ΓòÉΓòÉΓòÉ 4. Alt+1 key ΓòÉΓòÉΓòÉ
  72.  
  73. As in a Dir listing, the Alt+1 key can be pressed while the cursor is on an 
  74. entry in the Tree or Tree_dir output listing.  If the cursor is on a file, that 
  75. file will be loaded.  If the cursor is on a directory, then if the Tree_dir 
  76. command is available, a Tree_dir will be issued for that directory; if not, a 
  77. Dir will be issued. 
  78.  
  79.  
  80. ΓòÉΓòÉΓòÉ 5. Pop-up menu ΓòÉΓòÉΓòÉ
  81.  
  82. When in a Tree or Tree_dir output listing, the default pop-up menu is changed 
  83. to one that lets you load the current file, or sort the listing according to 
  84. any of the fields.  (The default way to get a pop-up menu is by pressing mouse 
  85. button 2, although this can be configured using the OS/2 System Setup.) 
  86.  
  87.  
  88. ΓòÉΓòÉΓòÉ 6. Output format ΓòÉΓòÉΓòÉ
  89.  
  90. The output from the Tree and Tree_dir commands contains columns for: 
  91.  
  92. Date      The date the file was last updated, in the format yyyy-mm-dd. 
  93.  
  94. Time      The time the file was last updated, in the format hh:mm:ss. 
  95.  
  96. FileSize  The size of the file, in bytes. 
  97.  
  98. EA-size   The number of bytes of extended attributes that the file has. 
  99.  
  100. Attr.     The file's attributes: 
  101.  
  102.    A  Archive 
  103.    D  Directory 
  104.    S  System 
  105.    H  Hidden 
  106.    R  Read-only 
  107.  
  108. Full name... (% = %d%p%f ; %f = %n.%e) The fully-qualified file name.  The text 
  109.           in parentheses is a reminder of the parameters for the TreeIt 
  110.           command. 
  111.  
  112.  
  113. ΓòÉΓòÉΓòÉ 7. TreeIt command ΓòÉΓòÉΓòÉ
  114.  
  115. This command executes any command against the files listed in a Tree or 
  116. Tree_Dir listing.  The syntax for this command is as follows: 
  117.  TREEIT [ /D ] command 
  118.  
  119. /D specifies that the command is to be applied to all files listed, including 
  120. directories.  The default is that directories will be skipped. 
  121.  
  122. If a range of lines is marked in the Tree or Tree-Dir file, the command will be 
  123. applied to those lines only, otherwise it will be applied to the entire file. 
  124.  
  125. The command can be any command which can be entered on the EPM command-line 
  126. (EPM internal, external, or OS/2).  This means that you can use EPM's MC 
  127. command to execute multiple commands against each file.  Substitution is 
  128. performed against strings starting with '%', as follows.  (Assume the file is 
  129. d:\path\name.ext.) 
  130.  
  131. %    The full file specifier, d:\path\name.ext 
  132. %f   The filename, name.ext 
  133. %p   The path portion of the file specifier, \path\ 
  134. %d   The drive, d: 
  135. %n   The name portion of the filename, name 
  136. %e   The extension portion of the filename, ext 
  137. %x   The full file specifier, d:\path\name.ext 
  138. %%   Used to specify a single '%' character in the resulting command. 
  139.  
  140. If no '%' appears in the command, the default is to append the full file 
  141. specifier to the end of the command. 
  142.  
  143. Examples: 
  144.  
  145. treeit e
  146.          Will edit each file, loading them into
  147.          the current edit window
  148. treeit copy % a:\
  149.          Will copy each file to the A drive
  150. treeit mc ,mkdir %d%pbackup, copy % %d%pbackup
  151.          Will copy each file to a backup directory
  152.          below the current file's directory.
  153.  
  154.  
  155. ΓòÉΓòÉΓòÉ 8. "Enter arguments" dialog ΓòÉΓòÉΓòÉ
  156.  
  157. This dialog prompts you to enter the arguments for a Tree or Tree_dir command 
  158. (as indicated in the dialog's title bar).  Enter the desired arguments, and 
  159. select OK to invoke the command, or select Cancel to cancel the dialog without 
  160. executing the command. 
  161.  
  162. Related information: 
  163.  
  164. Tree command 
  165. Tree_dir command 
  166.