home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / COMPRESS / DRX096.ZIP / DIRX.DOC < prev    next >
Encoding:
Text File  |  1990-12-30  |  7.5 KB  |  184 lines
  1.                         December 30, 1990
  2.  
  3.  
  4. DirX 0.96 - Directory of eXecutables.  Files compressed with AXE, DIET,
  5. LEXEM, LZEXE, PKLITE and TINYPROG are displayed in the left window.
  6. Uncompressed COM and EXE files are displayed in the right window.  "Move"
  7. individual and groups of files between the Compressed and Uncompressed
  8. windows.  Navigate between directories by pointing and shooting.  This
  9. release fixes a bug introduced in v0.95 related to scrolling.
  10.  
  11. Contents:
  12. =========
  13. Purpose
  14. Displayed data
  15. Syntax
  16. Configuration
  17. Commands
  18. Closing remarks
  19.  
  20. Purpose:
  21. ========
  22. To provide a simple command that will easily show which files have and have
  23. not been compressed with an executable file compressor.  It allows for easy
  24. compression and uncompression of individual and groups of files by
  25. user-selectable compression/uncompression programs.
  26.  
  27. DirX is a free program.
  28.  
  29. Displayed data:
  30. ===============
  31. If compressed executable files or regular COM/EXE files or any directories
  32. are found, two window pop up displaying any compressed files and/or
  33. directories on the left and any regular files on the right.  The window on
  34. the left is slightly wider to allow an abbreviated three-character
  35. identifier to precede each filename - currently "axe", "die", "lex", "lze",
  36. "pkl" or "tny" for files compressed with AXE, DIET, LEXEM, LZEXE, PKLITE or
  37. TINYPROG, respectively.
  38.  
  39. The program attempts to sense the type of display used and adjust color
  40. appropriately.  However, if the user has a color graphics card, but no
  41. color monitor, the display may be improved by using the DOS command "MODE
  42. BW80".
  43.  
  44. Syntax:
  45. =======
  46. Usage:  DIRX [d:][path][filespec]
  47.  
  48. There are no switches as of this release.
  49.  
  50. In the above syntax, if no argument follows the program name, the current
  51. default directory is searched, which is equivalent to "DIRX *.*".  If no
  52. file extension is specified, all extensions are searched.
  53.  
  54. Configuration:
  55. ==============
  56. Starting with Version 0.93, the user may create or edit a file named
  57. DIRX.CFG using an editor or word processor which can save pure ASCII text
  58. files.  DIRX.CFG should reside on the PATH, or in the current directory
  59. when DirX is run.  The contents of this file allows the user to specify
  60. which program will be invoked for compressing uncompressed files and which
  61. program(s) to use for uncompressing the related types of compressed files
  62. (axe, die, lex, lze, pkl, tny).  Although the syntax of DIRX.CFG allows for
  63. uncompression programs for any of the supported formats, the related
  64. uncompressing programs may not exist at the present time.
  65.  
  66. The syntax for specifying the *single* compression program is:
  67.  
  68. /C="<prognam>"
  69.  
  70. Do NOT enter the angle brackets.  Specific examples follow:
  71.  
  72. /C="PKLITE"
  73.  
  74. /C="DIET"
  75.  
  76. If DIRX.CFG contains more than one line with the correct syntax for
  77. specificing the compression program, the last one encountered before end of
  78. file will be used.
  79.  
  80. The syntax for specifying the uncompression program(s) is:
  81.  
  82. /U<xxx>="<prognam>"
  83.  
  84. Where <xxx> is "axe", "die", "lex", "lze", "pkl" or "tny" for files
  85. compressed with AXE, DIET, LEXEM, LZEXE, PKLITE or TINYPROG, respectively.
  86. Again, do NOT enter the angle brackets.  Specific examples follow:
  87.  
  88. /Upkl="PKLITE -x"
  89.  
  90. /Udie="DIET -r"
  91.  
  92. If DIRX.CFG contains more than one line with the correct syntax for
  93. specificing the uncompression program for the related type of compressed
  94. file, the last one encountered before end of file will be used.
  95.  
  96. In the above syntax for DIRX.CFG, neither leading and trailing spaces, nor
  97. any other extraneous characters are allowed.  Lines with invalid syntax are
  98. simply ignored.  This may actually be used to advantage, as shown in the
  99. sample DIRX.CFG file, where the single quote character is used to
  100. "comment-out" some of the non-applicable lines, but where the user may want
  101. to retain these lines to save retyping should he/she want to later change
  102. which is the active compression program, for example.
  103.  
  104. A sample DIRX.CFG file is included in the distribution archive, which the
  105. user may edit to "customize" DirX's behavior.
  106.  
  107. Commands:
  108. =========
  109. The current or active window is the one with the double frame.  Within the
  110. active window, <Home>, <End>, <PgUp>, <PgDn>, <UpArrow> and <DownArrow> may
  111. be used to navigate.  The <Tab> key will toggle the active window between
  112. the left and right panels.
  113.  
  114. If any directories are displayed in the left (Compressed) window, moving
  115. the file selection bar (highlight) over that directory and pressing
  116. <Return> will change the directory being viewed.  The file lists will be
  117. updated automatically.
  118.  
  119. A future release will allow changing the current default drive from within
  120. the program.
  121.  
  122. Pressing <F6> or the letter 'M' when no files have been selected will cause
  123. the Move command to act on the currently highlighted file.  If any files
  124. have been selected, the Move command acts on the selected files.
  125.  
  126. If the Move command is given while in the "Compressed" window, the DOS
  127. command "<compPrognam> <filename>" is executed for each selected file,
  128. where <compPrognam> is the name of the compression program and <filename>
  129. is the name of the file to compress.
  130.  
  131. If the Move command is given while in the "Uncompressed" window, the DOS
  132. command "<uncompPrognam> <filename>" is executed for each selected file,
  133. where <uncompPrognam> is the name of the uncompression program and
  134. <filename> is the name of the file to uncompress.
  135.  
  136. For compressing/uncompressing to work, the commands <compPrognam> and/or
  137. <uncompPrognam> should either be available in a directory included in the
  138. PATH environment variable, or in the current directory.
  139.  
  140. Files may be selected, or tagged, either individually or by wildcard
  141. selection.  The <Ins> key may be used as a toggle to select and unselect
  142. individual files.  Pressing <Ins> on an unselected file selects it.
  143. Pressing <Ins> on a selected file unselects it.  To select a group of files
  144. using DOS-type wildcards, press the plus ('+') key.  This opens up an input
  145. window into which a file specification may be entered.  To unselect a group
  146. of files, press the minus ('-').  This opens up an input window similar to
  147. the one for selection.
  148.  
  149. Pressing <F7> or the letter 'S' will open an input window for the user to
  150. enter a file specification to search for within the current window.  If
  151. wildcards are used, and the Search command is repeatedly invoked without
  152. changing the search specification, the program will cycle through all
  153. matching file names.
  154.  
  155. Pressing <Esc>, <F10> or the letter 'Q' will exit the program.
  156.  
  157. Closing remarks:
  158. ================
  159. The executable for this version is a little larger than it would otherwise
  160. be, even with the new features, as a little "debugging" code has been left
  161. in.  It is my hope that users encountering difficulty with the program, and
  162. noticing unexpected messages, will communicate these to me in detail -
  163. hopefully, in such detail that I can duplicate these problems.  When some
  164. of the wrinkles have been ironed out, the extra debugging code will be
  165. excluded in future releases.
  166.  
  167. In any case, even if problems are not encountered, if you find the program
  168. useful, E-mail sent to me at my CompuServe ID, or a postcard or letter,
  169. communicating this to me will always be appreciated.
  170.  
  171. I may be reached at the addresses below:
  172.  
  173.  
  174.                 By conventional mail:
  175.                 ---------------------
  176.                 Raymond T. Kaya
  177.                 P. O. Box 1436
  178.                 Honolulu, HI  96806
  179.  
  180.  
  181.                 By electronic mail:
  182.                 -------------------
  183.                 CompuServe:  71230,2500
  184.