home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / fileutil / drx101.arj / DIRX.DOC < prev    next >
Encoding:
Text File  |  1991-01-19  |  12.1 KB  |  277 lines
  1.                         January 19, 1991
  2.  
  3.  
  4. DirX 1.01 - Directory of eXecutables.  Files compressed with AXE, DIET,
  5. EXEPACK, LEXEM, LZEXE, PKLITE, SHRINK and TINYPROG are displayed in the
  6. left window.  Uncompressed COM/EXE files are displayed in the right window.
  7. Compress and uncompress individual and groups of files from within the
  8. program.  Navigate between drives/directories by pointing and shooting.
  9. New:  Pull-down menus and a few more options have been added.
  10.  
  11. Contents:
  12. =========
  13. Purpose
  14. Displayed data
  15. Syntax
  16. Configuration
  17. Commands
  18. Pull-down menus
  19. Closing remarks
  20.  
  21. Purpose:
  22. ========
  23. To provide a simple means of easily showing which files have and have not
  24. been compressed with an executable file compressor.  It allows for easy
  25. compression and uncompression of individual and groups of files by
  26. user-selectable compression/uncompression programs.
  27.  
  28. DirX is a free program.
  29.  
  30. Displayed data:
  31. ===============
  32. When the program is started, two window pop up displaying any compressed
  33. files and/or directories on the left and any regular files on the right.
  34. The window on the left is slightly wider to allow an abbreviated
  35. three-character identifier to precede each filename - currently "axe",
  36. "die", "epk", "lex", "lze", "pkl", "shr" or "tny" for files compressed with
  37. AXE, DIET, EXEPACK, LEXEM, LZEXE, PKLITE, SHRINK or TINYPROG, respectively.
  38.  
  39. In addition to the name, and type in the compressed window, the default
  40. display also shows the file size, date and time for each file.  Using the
  41. "Toggle" command, the current window can be set to show file attributes
  42. ("Attr"), the correct extension for the file if it has been misnamed
  43. ("Mis") and which version of the compressor was used in the case of LZEXE
  44. and PKLITE files.  In addition, files compressed with PKLITE Professional
  45. have an 'e' appended to the version number.
  46.  
  47. The program attempts to sense the type of display used and adjust color
  48. appropriately.  However, if the user has a color graphics card, but no
  49. color monitor, the display may be improved by using the DOS command
  50. "MODE BW80".
  51.  
  52. Syntax:
  53. =======
  54. Usage:  DIRX [d:][path][filespec]
  55.  
  56. In the above syntax, if no argument follows the program name, the current
  57. default directory is searched, which is equivalent to "DIRX *.*".  If no
  58. file extension is specified, all extensions are searched.
  59.  
  60. Configuration:
  61. ==============
  62. Starting with Version 0.93, the user may create or edit a file named
  63. DIRX.CFG using an editor or word processor which can save pure ASCII text
  64. files.  DIRX.CFG should reside on the PATH, or in the current directory
  65. when DirX is run.
  66.  
  67. In searching your path for DIRX.CFG, only the first 127 characters in your
  68. PATH statement will be searched.  For those with "extended" paths defined
  69. (PATH statements longer than 127 characters, please make sure that the path
  70. containing DIRX.CFG is completely specified before the 127-character limit
  71. has been reached.
  72.  
  73. The contents of this file allows the user to specify which program will be
  74. invoked for compressing uncompressed files and which program(s) to use for
  75. uncompressing the related types of compressed files (axe, die, epk, lex,
  76. lze, pkl, shr, tny).  Although the syntax of DIRX.CFG allows for
  77. uncompression programs for any of the supported formats, the related
  78. uncompressing program for a particular type may not exist at the present
  79. time.
  80.  
  81. The syntax for specifying the *single* compression program is:
  82.  
  83. /C="<command>"
  84.  
  85. Do NOT enter the angle brackets.  Specific examples follow:
  86.  
  87. /C="PKLITE"
  88.  
  89. /C="DIET"
  90.  
  91. If DIRX.CFG contains more than one line with the correct syntax for
  92. specifying the compression program, the last one encountered before end of
  93. file will be used.
  94.  
  95. The default command for specifying the method of compression may be
  96. temporarily overridden from within the program.  More about this later in
  97. the "Commands" section.
  98.  
  99. The syntax for specifying the uncompression program(s) is:
  100.  
  101. /U<xxx>="<command>"
  102.  
  103. Where <xxx> is "axe", "die", "epk", "lex", "lze", "pkl", "shr" or "tny" for
  104. files compressed with AXE, DIET, EXEPACK, LEXEM, LZEXE, PKLITE, SHRINK or
  105. TINYPROG, respectively.  Again, do NOT enter the angle brackets.  Specific
  106. examples follow:
  107.  
  108. /Upkl="PKLITE -x"
  109.  
  110. /Udie="DIET -r"
  111.  
  112. /Uepk="UPACKEXE"
  113.  
  114. If DIRX.CFG contains more than one line with the correct syntax for
  115. specifying the uncompression program for the related type of compressed
  116. file, the last one encountered before end of file will be used.
  117.  
  118. In the above syntax for DIRX.CFG, neither leading and trailing spaces, nor
  119. any other extraneous characters are allowed.  Lines with invalid syntax are
  120. simply ignored.  This may actually be used to advantage, as shown in the
  121. sample DIRX.CFG file, where the single quote character is used to
  122. "comment-out" some of the non-applicable lines, but where the user may want
  123. to retain these lines to save retyping should he/she want to later change
  124. which is the default compression program, for example.
  125.  
  126. A sample DIRX.CFG file is included in the distribution archive, which the
  127. user may edit to "customize" DirX's behavior.
  128.  
  129. Commands:
  130. =========
  131. The current or active window is the one with the solid frame.  Within the
  132. active window, <Home>, <End>, <PgUp>, <PgDn>, <UpArrow> and <DownArrow> may
  133. be used to navigate.  The <Tab> and right/left arrow keys will toggle the
  134. active window between the left and right panels.
  135.  
  136. If any directories are displayed in the left (Compressed) window, moving
  137. the file selection bar (highlight) over that directory and pressing
  138. <Return> will change the directory being viewed.  The file lists will be
  139. updated automatically.
  140.  
  141. Two shortcut keys are available for navigating directories while in the
  142. Compressed window:
  143.  
  144. "Ctrl \" changes the current directory to the root directory - similar to
  145. "CD \" at the DOS level.
  146.  
  147. "Ctrl <PgUp>" changes the current directory to the parent directory -
  148. similar to "CD .." at the DOS level.
  149.  
  150. To change the current default drive from within the program, use either
  151. "Alt <F1>" or "Alt <F2>".  A window indicating valid drives will pop up,
  152. allowing the user to select another drive by moving the highlight with the
  153. left and right arrow keys, then pressing <Return> to select the new drive.
  154. Press <Esc> to leave the default drive unchanged.  The drive changing
  155. feature is only valid when using versions of DOS numbered 3.0 or higher.
  156.  
  157. Pressing <F1> or the letter 'H' will display a brief help screen
  158. summarizing commonly used commands.  Press any key to close the help
  159. window.
  160.  
  161. Pressing <F3> or the letter 'D' will turn Directories-only mode on.  This
  162. feature was added by user request to speed up navigation.  To turn
  163. Directories-only mode off, press <F3> or 'D' a second time.
  164.  
  165. Pressing <F4> or the letter 'T' will toggle the active window's display to
  166. show additional information on the files being displayed, as previously
  167. described in the "Displayed data" section above.
  168.  
  169. Pressing <F6> or the letter 'M' when no files have been selected will cause
  170. the Move command to act on the currently highlighted file.  If any files
  171. have been selected, the Move command acts on the selected files.
  172.  
  173. If the Move command is given while in the "Compressed" window, the DOS
  174. command "<uncompPrognam> <filename>" is executed for each selected file,
  175. where <uncompPrognam> is the name of the uncompression program and
  176. <filename> is the name of the file to uncompress.
  177.  
  178. If the Move command is given while in the "Uncompressed" window, the DOS
  179. command "<compPrognam> <filename>" is executed for each selected file,
  180. where <compPrognam> is the name of the compression program and <filename>
  181. is the name of the file to compress.
  182.  
  183. Pressing "Alt <F6>" or "Alt M" from either the Compressed or Uncompressed
  184. window will open an input window which will allow the user to temporarily
  185. "Alter", or override, the method of compression currently defined in
  186. DIRX.CFG on the fly from within DirX.
  187.  
  188. For compressing/uncompressing to work, the commands <compPrognam> and/or
  189. <uncompPrognam> should either be available in a directory included in the
  190. PATH environment variable, or in the current directory.  Tip:  Either of
  191. these "programs" may be batch files.
  192.  
  193. Files may be selected, or tagged, either individually or by wildcard
  194. selection.  The <Ins> key may be used as a toggle to select and unselect
  195. individual files.  Pressing <Ins> on an unselected file selects it.
  196. Pressing <Ins> on a selected file unselects it.  To select a group of files
  197. using DOS-type wildcards, press the plus ('+') key.  This opens up an input
  198. window into which a file specification may be entered.  To unselect a group
  199. of files, press the minus ('-').  This opens up an input window similar to
  200. the one for selection.  The suggested keys are the gray plus and minus keys
  201. found near the numeric keypad of many keyboards.
  202.  
  203. Pressing <F7> or the letter 'S' will open an input window for the user to
  204. enter a file specification to search for within the current window.  If
  205. wildcards are used, and the Search command is repeatedly invoked without
  206. changing the search specification, the program will cycle through all
  207. matching file names.
  208.  
  209. Pressing <F9> or the letter 'P' or '/' will invoke the pull-down menu
  210. system.
  211.  
  212. Pressing <Esc>, <F10> or the letter 'Q' will exit the program.
  213.  
  214. Pull-down menus:
  215. ================
  216. The pull-down menu system duplicate in functionality many of the commands
  217. already described in the Commands section.  The purpose of this menu system
  218. is to de-emphasize the use of function keys and cryptic Alt- and Ctrl-key
  219. sequences when adding new commands in the future - one of which will allow
  220. printing directories.
  221.  
  222. The Move command, invoked by function key, is replaced by two separate
  223. commands in the pull-down menu system.  These are the "Compress" and
  224. "Uncompress" commands, listed under the "File" submenu.
  225.  
  226. For the Uncompress command to work, the Compressed window must be the
  227. current one.  This command is equivalent to using the Move command while in
  228. the Compressed window.
  229.  
  230. The Compress command, depending on which window is active, can act on files
  231. in either the Compressed or Uncompressed windows.  The purpose of allowing
  232. the user to *attempt to* compress already compressed files (something that
  233. is available from the command line anyway) is to facilitate experimentation
  234. on the effects of compressing by a variety of methods - compressing files
  235. already compressed with EXEPACK, for example.
  236.  
  237. Closing remarks:
  238. ================
  239. If you find this program useful, E-mail sent to me at my CompuServe ID, or
  240. a postcard or letter mailed to my P.O. Box, communicating this to me will
  241. always be appreciated.
  242.  
  243. While comments and suggestions on my freeware are welcome and encouraged,
  244. my personal preference is for small, simple utilities.  I take user
  245. feedback collectively as a pool from which to draw for ideas.  This being
  246. the case, please do not be offended if I don't incorporate your particular
  247. suggestion, as yours may possibly be one of many I receive, and my programs
  248. cannot be all things to all people.  In any case, please bear in mind that
  249. I'm currently employed full-time in a salaried, non-programming position,
  250. and that I'm only one person "supporting" my free utilities on my spare
  251. time.
  252.  
  253. Effective with Version 1.00, I will personally upload new public releases
  254. of DirX first to CompuServe's IBM PC Systems/Utilities Forum (GO IBMSYS),
  255. where the files are posted in Library 0 (New Uploads) for a period of 30
  256. days before they are moved into Library 6 (File Utilities).
  257.  
  258. Only *after* the distribution archives have been made available for public
  259. downloading on IBMSYS might I then personally upload copies of the these
  260. files to other networks or BBS's, if at all.  Downloaders are welcome to
  261. distribute copies of the distribution archives to other networks and BBS's.
  262. My upload policy is subject to change in the future.
  263.  
  264. I may be reached at the addresses below:
  265.  
  266.  
  267.                 By conventional mail:
  268.                 ---------------------
  269.                 Raymond T. Kaya
  270.                 P. O. Box 1436
  271.                 Honolulu, HI  96806
  272.  
  273.  
  274.                 By electronic mail:
  275.                 -------------------
  276.                 CompuServe:  71230,2500
  277.