home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / assemblr / library / sampler0 / mdir.doc < prev    next >
Text File  |  1986-02-11  |  6KB  |  121 lines
  1. MDIR  -  Memory resident DIRectory
  2.  
  3. MDIR is a small (assembly language based) memory resident routine
  4. that will display directory entries. MDIR gives both an
  5. "automatic" mode, where the current directory is shown sorted
  6. alphabetically, and a "command line" mode, where MDIR will
  7. "screen" files (like the DOS DIR command does), and display the
  8. file list with your choice of sort mechanism (by date/time, name,
  9. extension, unsorted).
  10.  
  11. This routine takes about 14k of memory when installed, and can
  12. make use of a second screen (if you have both monochrome and
  13. color/graphics installed).
  14.  
  15. This routine will put the directory on the "alternate" screen if
  16. two monitors are available.  
  17.  
  18. Usage:
  19.           MDIR
  20.            <or>
  21.           MDIR 2
  22.  
  23. causes MDIR to install itself in memory.
  24.  
  25. The 2 indicates that both a color and a monochrome monitor are
  26. available on the system.  (MDIR does NOT check to see if the
  27. second monitor is actually installed.)  If you tell the routine
  28. that both monitors are available, the directory will be printed
  29. to the monitor that is NOT currently being used.
  30.  
  31. If only ONE monitor is installed, or if MDIR is executed without
  32. the '2' on the command line, then the directory will be shown on
  33. the monitor that is currently being used.  If this is the case,
  34. MDIR will "save" the screen currently being used, and restore it
  35. when done.
  36.  
  37. To use MDIR once it has been installed, it is activated by
  38. pressing either the <Alt><8> or the <Alt><9> key combinations
  39. together (where the number keys are those above the alpha keys on
  40. the keyboard, NOT the ones from the numeric keypad).
  41.  
  42. If you press the <Alt><8> keys, the directory will be displayed
  43. in alphabetical order. If you press <Alt><9>, MDIR will prompt
  44. you for a "command line" to be used.  The command line can
  45. duplicate a command given to the DOS DIR command.  For example:
  46.  
  47. [assume the <Alt><9> keys have been pressed together]
  48.  
  49.         MDIR prompt             your response              results
  50. ╔════════════╧═════════════╗ ╔═════════╧══════════╗ ╔═════════╧══════════╗
  51. command line (/H for help):  *.*                    all files in the current
  52.                                                     directory
  53.                              \masm\files            all files in the sub-
  54.                                                     directory named
  55.                                                     \masm\files
  56.                              *.pas                  any file in the current
  57.                                                     directory with the
  58.                                                     extension .PAS
  59.                              \masm\files\*.arc      any file in the sub-
  60.                                                     directory named
  61.                                                     \masm\files with the
  62.                                                     extension .ARC
  63.                              b:*.*                  all files in the
  64.                                                     current directory
  65.                                                     on drive B:
  66.  
  67. In addition, there are several options, detailed below, that are
  68. triggered by the / switch.  /H given at the command line will list 
  69. the options.
  70.  
  71.      [options] * /A - List hidden files.
  72.                * /W - wait when screen full.
  73.                * /R - Include directory entries.
  74.                * /M - Display Modified entries only.
  75.                  /X - Sort by extension.
  76.                  /S - Sort by size.
  77.                  /D - Sort by date/time.
  78.                  /N - Do not sort, original order.
  79.                  /H - Help - only display options.
  80.        Default = *.* sorted by name.ext with screen erase.
  81.        * - Option may be combined with other options.
  82.  
  83.  
  84.  
  85. CAVEATS:
  86.    1.  Because MDIR reads information from the disk, avoid
  87.        "triggering" this utility when an operating program
  88.        is working with the disks -- results can be
  89.        unpredictable (and fatal).
  90.    2.  The code is set up to prevent MDIR from being triggered twice
  91.        in a row -- a key other than the "trigger" keys must be pressed
  92.        between uses.
  93.    3.  MDIR currently saves space for 256 directory entries.  If you
  94.        need more space, please adjust the source code.
  95.    4.  MDIR does its best to trap floppy disk errors -- such as an open
  96.        door on a floppy disk drive.  MDIR does NOT check to see if a
  97.        hard drive is ready.
  98.    5.  Some software saves information in the alternate pages of
  99.        the video memory IF you are using a color/graphics adaptor
  100.        (PC-Write, for example, stores its help screens in the memory
  101.        of the other c/g pages).  MDIR only saves the current video
  102.        page, so you can scramble help screens when MDIR switches
  103.        monitors.
  104.    6.  MDIR doesn't check if a drive has been ASSIGNed.  If you
  105.        request a directory for drive B:, MDIR will look for physical
  106.        drive B:.
  107.  
  108. I've used this routine with a variety of software, including:
  109.        Lotus' 123
  110.        PC-Write
  111.        PC-TALK
  112.        TURBO Pascal
  113.  
  114. Source code (with its origins mentioned) is included in this archive.
  115. Please do with it what you will to tweek it to your system/preferences.
  116.  
  117. Please let me know about any bugs/comments that you have via
  118. Gene Plantz' IBBS, 312-882-4227.
  119.                                                      Mike Pechnyo
  120.                                                      ID1206
  121.