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