home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / UTILS1 / DMAV10.ZIP / DM.DOC < prev    next >
Text File  |  1994-02-18  |  10KB  |  209 lines
  1.                               Directory Maven
  2.                                 Version 1.0
  3.  
  4.                       Copyright (C) 1994 Kent Briggs
  5.                             All Rights Reserved
  6.  
  7.  
  8.      Purpose
  9.      -------
  10.      maven (MAY vin) n. expert or connoisseur, devotee.
  11.  
  12.      Directory Maven is DOS utility program that allows the user to
  13.      quickly change to another directory across any drive (quick mode
  14.      option) or to view the directory structure of all drives in a
  15.      graphical tree format (tree mode option).
  16.  
  17.      License
  18.      -------
  19.      Directory Maven is Freeware, i.e. copyrighted software that may be
  20.      freely distributed and used indefinitely without payment to the
  21.      author.  The only restrictions that apply are that the program
  22.      files must be distributed together and unmodified, including the
  23.      documentation files.  This software is provided as is and without
  24.      warranty.  The author assumes no liability for damages, either
  25.      direct or consequential, which may result from the use of this
  26.      product.
  27.  
  28.      Installation
  29.      ------------
  30.      Copy DM.EXE into one of your path directories so that it can be
  31.      executed from any directory.  Type PATH at the DOS command line to
  32.      see a list of your path directories, each separated by a ";".  I
  33.      always create a C:\GLOBAL directory on the computers I use and add
  34.      this directory to the PATH statement in my AUTOEXEC.BAT file.  This
  35.      is where I place all my shareware/freeware DOS utility programs.
  36.      Remember, if you modify your AUTOEXEC.BAT file, the changes do not
  37.      take effect until you reboot your computer.
  38.  
  39.      Scan File
  40.      ---------
  41.      Directory Maven scans the directories on your drives and stores
  42.      this list in a file called DM.DAT.  By default, DM.DAT will be
  43.      stored in the same directory as DM.EXE.  However, this will cause
  44.      problems if DM.EXE is on a network drive and being shared by many
  45.      users.  Therefore, Directory Maven will first look for a DOS
  46.      environment variable called DIRMAVEN that points to the location of
  47.      DM.DAT.  Use the SET command in your AUTOEXEC.BAT file to define an
  48.      environment variable (e.g. SET DIRMAVEN=C:\GLOBAL).  If this
  49.      variable does not exist then Directory Maven looks for a one-line
  50.      ASCII text file called DM.CFG in the same directory as DM.EXE.
  51.      DM.CFG will specify the location of DM.DAT.  To create a DM.CFG
  52.      file that specifies C:\ as the DM.DAT directory, type the following
  53.      lines at the DOS command line:
  54.  
  55.      COPY CON DM.CFG <Enter>
  56.      C:\ <Enter>
  57.      <Ctrl-Z> <Enter>
  58.  
  59.      Finally, if DM.CFG does not exist, then Directory Maven stores
  60.      DM.DAT in the same directory as DM.EXE.
  61.  
  62.      First Time Operation
  63.      --------------------
  64.      Start Directory Maven by typing DM at the DOS command line and
  65.      press Enter.  Press F2.  Type in the letters representing the
  66.      drives you want scanned.  Your active drives are shown in black in
  67.      the upper left corner of the screen.  Normally, you would not scan
  68.      removable media drives such as floppy or CD-ROM drives, although
  69.      you can if you want to.  Press Enter to scan the drives and create
  70.      the DM.DAT scan file.  After scanning, press Esc or Alt-X to exit
  71.      Directory Maven.
  72.  
  73.      Quick Mode Operation
  74.      --------------------
  75.      To quickly change to another directory (even if it is on another
  76.      drive) enter one of the following commands at the DOS prompt:
  77.  
  78.      DM partial_directory_name
  79.      DM *partial_directory_name
  80.  
  81.      where partial_directory_name could be something like "my" when
  82.      you want to change to a directory that starts with "my" such as
  83.      "C:\LOTUS\MYFILES".  Precede the name with an "*" to find matches
  84.      within the directory name.  For example, "DM file" would not find
  85.      "C:\LOTUS\MYFILES" but "DM *file" would.
  86.  
  87.      Directory Maven will look in DM.DAT for exact and partial matches
  88.      to "file".  If only one match is found, then Directory Maven will
  89.      change to that directory and exit.  If more than one match is
  90.      found, a pop-up list will be displayed showing all matches.  Exact
  91.      matches will be shown at the top of the list followed by partial
  92.      matches.  Cursor to the one you want and press Enter or press Esc
  93.      to cancel.  Up to 999 matches will appear in the list.  Matches on
  94.      inactive drives (e.g. network drives when not logged in) will not
  95.      be shown.
  96.  
  97.      Adding New Directories To Scan File
  98.      -----------------------------------
  99.      To add a single directory to the DM.DAT scan file without
  100.      rescanning the entire drive, change to the new directory using the
  101.      DOS CD command and use the Add switch:
  102.  
  103.      DM /a
  104.  
  105.      The parent directory of the new directory must already exist in
  106.      the scan file or the add operation will fail.
  107.  
  108.      Tree Mode Operation
  109.      -------------------
  110.      Run Directory Maven in Tree Mode to see a graphical tree
  111.      representation of your drives.  Start DM without any command line
  112.      parameters to run in Tree Mode.  Your active drives are shown in
  113.      black in the upper left corner of the screen.  Previously scanned
  114.      drives that are currently inactive are shown in gray.  Examples of
  115.      inactive drives might include network drives when you are logged
  116.      out of the network, RAM drives and CD-ROM drives when the drivers
  117.      were not loaded during this session, etc.
  118.  
  119.      Directory Tree Navigation
  120.      -------------------------
  121.      The directory tree for the current drive will be displayed on start
  122.      up.  The current directory will be shown in yellow (if previously
  123.      scanned).  Use the cursor keys, PageUp/PageDn, and Home/End keys to
  124.      move through the tree.  Hold the shift key down when using the
  125.      up/down arrow keys to stay in the same tree level.  Press the left
  126.      arrow key to move to the parent of the current directory.  When the
  127.      root directory is highlighted, the date and time the drive was last
  128.      scanned is shown on the bottom status line.  Use the Tab and Shift-Tab
  129.      keys to move to other drives.  Press F1 to display the help screen.
  130.  
  131.      Speed Search
  132.      ------------
  133.      To move quickly to a directory (current drive only) in tree mode,
  134.      begin typing the characters in the name.  The cursor will jump to
  135.      the next match found with each keystroke.  Press Alt-N during Speed
  136.      Search to look for other matches based on the characters you typed
  137.      in so far.  Press Esc or any of the cursor keys to exit Speed Search.
  138.  
  139.      Scanning Drives
  140.      ---------------
  141.      Press F2 to rescan one or more drives.  If you want to include
  142.      hidden directories, press Shift-F2 instead.  Type in the letters
  143.      representing the drives to scan.  Press Enter to start or Esc to
  144.      cancel.  Only the active drives (shown in black in the upper left
  145.      corner) can be scanned, up to 999 directories each (memory
  146.      permitting).  Drives previously scanned, but not scanned this
  147.      time will remain in the scan file unchanged.
  148.  
  149.      Removing Drives and Directories
  150.      -------------------------------
  151.      To remove a single directory from the scan file, move the cursor
  152.      to the directory and press Delete.  You cannot remove a directory
  153.      if it has subdirectories (unless you remove the subdirectories
  154.      first).  To remove a drive from the scan file (including inactive
  155.      drives), make that drive current using the Tab or Shift-Tab keys,
  156.      and press Shift-Delete.  Note: these commands only remove the
  157.      directories from the DM.DAT scan file, they do not erase files or
  158.      directories from your hard drive.
  159.  
  160.      Printing
  161.      --------
  162.      Press Alt-P to print the directory tree for the current directory.
  163.      The following prompt will appear:
  164.  
  165.      Print tree to LPT (1,2,3):
  166.  
  167.      Press "1" to print to LPT1, "2" for LPT2, etc.  Press Esc to
  168.      cancel printing.  Make sure your printer is set up to print
  169.      extended ASCII characters.  For most HP laser printers, the symbol
  170.      set needed is "PC-8".
  171.  
  172.      Exit Directory Maven
  173.      --------------------
  174.      Press Enter to change to the drive/directory highlighted and exit
  175.      Directory Maven.  Press Esc or Alt-X to exit Directory Maven
  176.      without changing directories.
  177.  
  178.      Misc Information
  179.      ----------------
  180.      Version 1.0 -- initial release.
  181.      Directory Maven was written in Borland Pascal 7.0, approximately
  182.      1300 lines of code.
  183.  
  184.      Other Programs by the Author
  185.      ----------------------------
  186.      If you like Directory Maven, please try my shareware product
  187.      File Maven, a DOS file manager that supports copy/move/delete
  188.      file operations including null-modem file transfers.  Look for
  189.      FMAVxx.ZIP on your favorite BBS/Disk Distributor or one of these
  190.      sources:
  191.  
  192.      Compuserve                       ; GO IBMSYS
  193.      The Consultant BBS  718-837-3236 ; ASP Hub, free 1st call download
  194.      Space BBS           415-323-4193 ; ASP Hub, free 1st call download
  195.      Exec-PC             414-789-4210 ; Largest BBS in USA, fee required
  196.      ASP CD-ROM                       ; Software from Association of
  197.                                       ; Shareware Professionals authors
  198.  
  199.      Please send suggestions for improvement to:
  200.  
  201.      Kent Briggs
  202.      109A Romana Circle
  203.      Hewitt, TX  76643
  204.  
  205.      My Compuserve ID is [72124,3234].  Fidonet users can find me in
  206.      the SHAREWRE and PASCAL echos or send Netmail to me at 1:388/26
  207.      or 1:154/280.
  208.  
  209.