home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / UTILITY / FILE / DRX109.ZIP / DIRX.DOC < prev    next >
Encoding:
Text File  |  1992-06-14  |  11.7 KB  |  279 lines
  1. DirX-Directory of eXecutables, Version 1.09            14-Jun-92
  2.  
  3.  
  4. Shell for detecting files compressed by several executable file compressors. 
  5. Employs external compressors and uncompressors (user-selectable) to
  6. transparently compress and uncompress files from within the program. 
  7. Currently supported are AXE, DIET, EXEPACK, ICE, LEXEM, LZEXE, PKLITE,
  8. SCRNCH, SHRINK and TINYPROG.  New:  DIRX.CFG may now include command-line
  9. switches.
  10.  
  11. Contents:
  12. =========
  13. Purpose
  14. Display
  15. Syntax
  16. Switches
  17. Configuration
  18. Commands
  19. Pull-down menus
  20.  
  21. Purpose:
  22. ========
  23. To show which .EXE and .COM files have and have not been compressed by one
  24. of the supported executable file compressors and to allow for transparent
  25. compression and uncompression of individual and groups of files by
  26. user-selectable compress and uncompress commands.
  27.  
  28. DirX is a free program.
  29.  
  30. Display:
  31. ========
  32. When the program is started, two windows pop up displaying any compressed
  33. files and/or directories on the left and any non-compressed files on the
  34. right.  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", "ice", "lex", "lze", "pkl", "scr", "shr" or "tny" for files
  37. compressed by AXE, DIET, EXEPACK, ICE, LEXEM, LZEXE, PKLITE, SCRNCH, SHRINK
  38. and TINYPROG, respectively.
  39.  
  40. In addition to the file name, and type in the compressed window, the default
  41. display also shows the file size, date and time for each file.  Using the
  42. "Toggle" command, the current window can be set to show any special
  43. characteristics ("Special"), file attributes ("Attr"), the probable correct
  44. extension for the file name if it has been misnamed ("Mis") and which
  45. version of the compressor was used in the case of DIET, LZEXE, PKLITE and
  46. TINYPROG files.
  47.  
  48. Please note that as DIET, at least up until version 1.44, does not
  49. explicitly store the version number, any version number greater than 1.00
  50. can only be interpreted in the "greater than or equal to" sense.  Thus a
  51. reading of "1.01" means that a version of DIET equal to 1.01, or higher, was
  52. used to compress a file.
  53.  
  54. Files compressed with PKLITE Professional's extra-compression option have an
  55. 'e' appended to the version number.
  56.  
  57. Special characteristics displayed using the Toggle command are as follows: 
  58. For the Compressed window, "dat" for "data" files (non-executables)
  59. compressed with DIET.  For the Uncompressed window, "ovl" for possible
  60. executables containing overlays, "win" for Windows/OS2 executables and "lhi"
  61. for LoadHi executables.
  62.  
  63. The program displays either in color or "black-and-white" based on the video
  64. mode at program start-up.  However, if the user has a color graphics card,
  65. but no color monitor, the display may be improved by using the DOS command
  66. "MODE BW80".  Conversely, color mode may be forced on by using "MODE CO80".
  67.  
  68. A command-line switch is also available to force black-and-white mode.  See
  69. "Switches" below.
  70.  
  71. EGA/43- and VGA/50-line modes are supported.  At program start-up, an
  72. attempt is made to detect the actual number of lines on the screen, up to a
  73. maximum of 50, and to adjust the display accordingly.
  74.  
  75. Syntax:
  76. =======
  77.  
  78.      Usage:  DIRX [switches] [filespec]
  79.  
  80. In the above syntax, if no argument follows the program name, the current
  81. default directory is searched, which is equivalent to "DIRX *.*".  If no
  82. file extension is specified, all extensions are searched.
  83.  
  84. Switches:
  85. =========
  86. /A      display Alternate info for both windows at start-up.  Simpler than
  87.         selecting each window in turn from within the program and using the
  88.         Toggle command twice.
  89.  
  90. /BW     Black-and-White mode.  Provided as an alternative to using DOS's
  91.         "MODE BW80" command.
  92.  
  93. Either '/' or '-' may be used to specify switches.
  94.  
  95. Entering an invalid switch causes the program to display a brief help screen
  96. then exit.
  97.  
  98.         Examples:       DIRX /h
  99.                         DIRX -?
  100.  
  101. Configuration:
  102. ==============
  103. An optional configuration file containing user-selected default switches may
  104. be created or edited with any editor or word processor which can save pure
  105. ASCII text files.  This file should be named "DIRX.CFG" and placed in the
  106. same directory from which DIRX.EXE will be loaded (DOS 3.0 and above).
  107.  
  108. Switches, including switch options, may be separated by spaces or placed on
  109. separate lines.
  110.  
  111. In addition to specifying "true" switches, DIRX.CFG should also contain
  112. lines assigning which commands to use for compressing and uncompressing
  113. files of the appropriate type.  Although the syntax of DIRX.CFG allows for
  114. uncompress commands for any of the supported formats, the related
  115. decompressor for a particular type may not exist at the present time.
  116.  
  117. The syntax for specifying the *single* compress command is:
  118.  
  119. /C="command"
  120.  
  121. Where:  "command" should be set to the command line, including arguments, of
  122.           the compress command you wish to run.
  123.  
  124. "command" would typically include both the "%f" and "%e" format specifiers,
  125. which represent the filename and extension, respectively, of the selected
  126. file.
  127.  
  128. If "filename.ext" is a target file, then %f represents the "filename"
  129. portion of the complete filename, and %e represents the ".ext" part.
  130.  
  131.         Examples:       /C="PKLITE %f%e"
  132.                         /C="AXE %f%e -n"
  133.                         /C="EXEPACK %f%e %f.EPK"
  134.  
  135. If DIRX.CFG contains more than one line with the correct syntax for
  136. specifying the compress command, the last one encountered before end of file
  137. will be used.
  138.  
  139. The default command for specifying the method of compression may be
  140. temporarily overridden from within the program.  More about this later in
  141. the "Commands" section.
  142.  
  143. The syntax for specifying the uncompress commands is:
  144.  
  145. /U<xxx>="command"
  146.  
  147. Where:  <xxx> is "axe", "die", "epk", "ice", "lex", "lze", "pkl", "scr",
  148.           "shr" or "tny" for files compressed with AXE, DIET, EXEPACK, ICE,
  149.           LEXEM, LZEXE, PKLITE, SCRNCH, SHRINK or TINYPROG, respectively.
  150.  
  151. "command" would be formed similarly to specifying the compress command.
  152.  
  153.         Examples:       /Upkl="PKLITE %f%e -x"
  154.                         /Udie="DIET -ra %f%e"
  155.                         /Uepk="UPACKEXE %f%e"
  156.  
  157. If DIRX.CFG contains more than one line with the correct syntax for
  158. specifying the uncompress command for the related type of compressed file,
  159. the last one encountered before end of file will be used.
  160.  
  161. True switches should be placed on separate lines from those assigning
  162. commands.
  163.  
  164.  
  165. A sample DIRX.CFG file is included in the distribution archive for DirX,
  166. which the user may edit to "customize" DirX's behavior.
  167.  
  168. Commands:
  169. =========
  170. The current or active window is the one with the solid frame.  Within the
  171. active window, <Home>, <End>, <PgUp>, <PgDn>, <UpArrow> and <DownArrow> may
  172. be used to navigate.  The <Tab> and right/left arrow keys will toggle the
  173. active window between the left and right panels.
  174.  
  175. If any directories are displayed in the left (Compressed) window, moving the
  176. file selection bar (highlight) over that directory and pressing <Return>
  177. will change the directory being viewed.  The file lists will be updated
  178. automatically.
  179.  
  180. Two shortcut keys are available for navigating directories while in the
  181. Compressed window:
  182.  
  183. "Ctrl \" changes the current directory to the root directory - similar to
  184. "CD \" at the DOS level.
  185.  
  186. "Ctrl <PgUp>" changes the current directory to the parent directory -
  187. similar to "CD .." from DOS.
  188.  
  189. To change the current default drive from within the program, use either "Alt
  190. <F1>" or "Alt <F2>".  A window indicating valid drives will pop up, allowing
  191. the user to select another drive by moving the highlight with the left and
  192. right arrow keys, then pressing <Return> to select the new drive.  As an
  193. alternative, you may also type the letter of the drive.  Press <Esc> to
  194. leave the default drive unchanged.  The drive changing feature is only valid
  195. when using versions of DOS numbered 3.0 or higher.
  196.  
  197. Pressing <F1> or the letter 'H' will display a brief help screen summarizing
  198. commonly used commands.  Press any key to close the help window.
  199.  
  200. Pressing <F3> or the letter 'D' will turn Directories-only mode on.  To turn
  201. Directories-only mode off, press <F3> or 'D' a second time.  (This feature
  202. was added by user request to speed up navigation on a relatively slow
  203. machine.)
  204.  
  205. Pressing <F4> or the letter 'T' will toggle the active window's display to
  206. show additional information on the files being displayed, as previously
  207. described in the "Displayed data" section above.
  208.  
  209. Pressing <F6> or the letter 'M' when no files have been selected will cause
  210. the Move command to act on the currently highlighted file.  If any files
  211. have been selected, the Move command acts on the selected files.
  212.  
  213. If the Move command is given while in the "Compressed" window, the
  214. uncompress command is executed for each selected file.
  215.  
  216. If the Move command is given while in the "Uncompressed" window, the
  217. compress command is executed for each selected file.
  218.  
  219. Pressing "Alt <F6>" or "Alt M" from either the Compressed or Uncompressed
  220. window will open an input window which will allow the user to temporarily
  221. "Alter", or override, the method of compression currently defined in
  222. DIRX.CFG, on the fly, from within DirX.
  223.  
  224. For compressing and uncompressing to work, the appropriate commands should
  225. either be available in a directory included in the PATH environment
  226. variable, or in the current directory.
  227.  
  228. Files may be tagged either individually or by wildcard selection.  The <Ins>
  229. key may be used as a toggle to select and unselect individual files. 
  230. Pressing <Ins> on an unselected file selects it.  Pressing <Ins> on a
  231. selected file unselects it.  To select a group of files using DOS-type
  232. wildcards, press the plus ('+') key.  This opens up an input window into
  233. which a file specification may be entered.  To unselect a group of files,
  234. press the minus ('-').  This opens up an input window similar to the one for
  235. selection.  The suggested keys are the gray plus and minus keys found near
  236. the numeric keypad of many keyboards.
  237.  
  238. Pressing <F7> or the letter 'S' will open an input window for the user to
  239. enter a file specification to search for within the current window.  If
  240. wildcards are used, and the Search command is repeatedly invoked without
  241. changing the search specification, the program will cycle through all
  242. matching file names.
  243.  
  244. Pressing <F9> or the letter 'P' or '/' will invoke the pull-down menu
  245. system.
  246.  
  247. Pressing <Esc>, <F10> or the letter 'Q' will exit the program.
  248.  
  249. Pull-down menus:
  250. ================
  251. The pull-down menu system duplicates in functionality many of the commands
  252. already described in the Commands section.  The purpose of this menu system
  253. is to de-emphasize the use of function keys and cryptic Alt- and Ctrl-key
  254. sequences when adding new commands in the future.
  255.  
  256. The Move command, invoked by function key, is replaced by two separate
  257. commands in the pull-down menu system.  These are the "Compress" and
  258. "Uncompress" options, listed under the "File" submenu.
  259.  
  260. For the Uncompress menu option to work, the Compressed window must be the
  261. current one.  This option is equivalent to using the Move command while in
  262. the Compressed window.
  263.  
  264. The Compress menu option, depending on which window is active, can act on
  265. files in *either* the Compressed or Uncompressed windows.  The purpose of
  266. allowing the user to *attempt to* compress already compressed files
  267. (available from the command line anyway) is to facilitate experimentation on
  268. the effects of compression by a variety of methods - compressing files
  269. already compressed with EXEPACK, for example.
  270.  
  271. --
  272.  
  273.                 Raymond T. Kaya
  274.                 P. O. Box 1436
  275.                 Honolulu, HI  96806
  276.  
  277.                 CompuServe:  71230,2500
  278.                 GEnie     :  R.KAYA1
  279.