home *** CD-ROM | disk | FTP | other *** search
/ Boldly Go Collection / version40.iso / TS / 25D / TLADPP30.ZIP / DPP.DOC < prev    next >
Encoding:
Text File  |  1992-01-01  |  9.8 KB  |  312 lines
  1.                        ∙Thom∙Little∙Associates∙
  2.  
  3.                 - tlaDPP30.zip - Directory Push/Pop -
  4.                              Version 3.00
  5.  
  6.  
  7. tlaDPP30.zip CONTENTS:
  8.  
  9.      DPOP.COM     Command to remove most recently added drive-directory
  10.                   from the resident drive-directory stack.
  11.  
  12.      DPOPALL.COM  Command to clear all drive-directories from the
  13.                   resident drive-directory stack and set drive-
  14.                   directory to the first drive-directory added to the
  15.                   resident drive-directory stack.
  16.  
  17.      DPRES.COM    Terminate and Stay Resident (TSR) module that
  18.                   contains the resident drive-directory stack.
  19.  
  20.      DPUSH.COM    Command to add a drive-directory to the resident
  21.                   drive-directory stack.
  22.  
  23.      DPP.DOC      This documentation file.
  24.  
  25.      DP.EXE       Command line interface for DPP.
  26.  
  27.      GO.EXE       Command to transfer to a drive-directory without
  28.                   saving anything in the resident drive-directory
  29.                   stack.
  30.  
  31.  
  32. PURPOSE:
  33.  
  34. The support for directories in the DOS system is somewhat limited. 
  35. The modules contained here lift some of those limitations.
  36.  
  37. The module DPRES.COM is installed when you load your system.  It
  38. contains a stack large enough to hold eight drive-directory
  39. identifications.  The other modules interact with DPRES.COM to allow
  40. you to rapidly move to any drive-directory on your system and return
  41. to the location from which you came.
  42.  
  43.  
  44. BATCH FILE OPERATION:
  45.  
  46. Three commands are included that are used primarily in batch files. 
  47. These are:
  48.  
  49.      DPUSH.COM is used to add the current drive-directory to the stack.
  50.  
  51.      DPOP.COM is used to remove the most recently added drive-
  52.      directory from the stack and make this the current drive-
  53.      directory.
  54.  
  55.      DPOPALL.COM is used to purge all the drive-directory elements
  56.      from the stack and make the oldest entry in the stack the
  57.      current drive-directory.
  58.  
  59. Assume that the current drive is C: and the current directory is
  60. \COM\PCP and that you execute the following batch file:
  61.  
  62.     @ECHO OFF
  63.      DPUSH
  64.      G:
  65.      CD \WINDOWS
  66.      WIN
  67.      DPOP
  68.  
  69. DPUSH saves the current drive-directory.  The batch file sets the
  70. drive-directory to G:\WINDOWS,  The batch file then invokes WIN. 
  71. When WIN completes, DPOP restores the drive-directory to C:\COM\PCP.
  72.  
  73. You can now have batch files that create the specialized
  74. environments that are needed for your applications and then return
  75. to the environment from which it was called.
  76.  
  77. You can DPUSH up to eight drive/directories onto the stack and DPOP
  78. your way back through the drive/directories that you DPUSHed.
  79.  
  80. There are special cases when you will just want to ignore everything
  81. in the drive-directory stack and go "home."  You can easily do this
  82. by issuing the DPOPALL command.  This will purge all entries from the
  83. stack and set the current drive-directory to the first drive-
  84. directory that you had added to the drive-directory stack.
  85.  
  86.  
  87. COMMAND LINE OPERATION
  88.  
  89. The program DP.EXE is included to allow easy manipulation of the
  90. drive-directory stack from the DOS command line.  DP.EXE invokes
  91. DPUSH, DPOP, and DPOPALL to manipulate the drive-directory stack in
  92. DPRES.
  93.  
  94. Assume that you are positioned at C:\COM\PCP.  The command:
  95.  
  96.      DP G:\WINDOWS
  97.  
  98. will do a DPUSH (add C:\COM\PCP to the drive-directory stack) and make
  99. G:\WINDOWS the current drive-directory.
  100.  
  101. The command:
  102.  
  103.      DP
  104.  
  105. will DPOP (set the current drive-directory to the last drive-directory
  106. added to the drive-directory stack) you back to C:\COM\PCP.
  107.  
  108. The batch file example presented earlier could be replace with the
  109. following batch file that performs the identical function:
  110.  
  111.     @ECHO OFF
  112.      DP G:\WINDOWS
  113.      WIN
  114.      DP
  115.  
  116. In addition you can purge the drive-directory stack and set the
  117. current drive-directory to the oldest entry in the stack by issuing:
  118.  
  119.      DP /CLEAR
  120.  
  121. GO.EXE is also included for use from the command line.  It provides
  122. the function of a DOS drive command followed by a DOS change
  123. directory command.  It does not interact with the resident
  124. drive-directory stack in DPRES.
  125.  
  126. If you have a system with multiple drives you probably issue many
  127. command sequence like:
  128.  
  129.      D:
  130.      CD \DOS\BIN\MASM
  131.  
  132. to first set the drive and then set the directory.
  133.  
  134. This same operation can be performed by:
  135.  
  136.      GO D:\DOS\BIN\MASM
  137.  
  138.  
  139. COMMAND SYNTAX:
  140.  
  141.      dpop
  142.      dpopall
  143.      dpush
  144.      dpres
  145.      
  146.      dp [drive-directory-name]
  147.      dp /clear
  148.      dp /?
  149.  
  150.      go drive-directory-name
  151.  
  152.  
  153.      drive-directory-name
  154.  
  155.                   Defines the DOS drive-directory name to set as the
  156.                   current drive-directory
  157.      
  158.      /clear       
  159.  
  160.                   Purge the resident drive-directory stack and set
  161.                   the current drive-directory to the oldest entry in
  162.                   the resident drive-directory stack.
  163.  
  164.      /?
  165.  
  166.                   List an abbreviated description of the command
  167.                   syntax.
  168.  
  169.  
  170. SAMPLE COMMANDS:
  171.  
  172.      dp g:\win        DPUSH current drive-directory onto stack and set
  173.                       current drive-directory to G:\WIN.
  174.  
  175.      dp               DPOP most recent drive-directory from stack and
  176.                       make it the current drive-directory.
  177.  
  178.      dp /clear        DPOPALL to clear all elements from the stack and
  179.                       make the oldest entry the current drive-
  180.                       directory.
  181.      
  182.      dp /?            list command syntax.
  183.  
  184.  
  185. INSTALLATION:
  186.  
  187. To use this facility on your machine, you need to do two things:
  188.  
  189. 1.   Copy the executable modules to a subdirectory that exists on your
  190.      system path.
  191.  
  192.      As an example, on our systems this directory is at D:\DOS\TLA. 
  193.      To install this facility, if the executable modules are in the
  194.      current drive-directory, we would enter:
  195.  
  196.           COPY *.COM D:\DOS\TLA
  197.           COPY *.EXE D:\DOS\TLA
  198.  
  199.      The first command will copy DPOP.COM, DPOPALL.COM, DPRES.COM,
  200.      and DPUSH.COM to D:\DOS\TLA.  The second command will copy
  201.      DP.EXE and GO.EXE to D:\DOS\TLA.
  202.  
  203. 2.   Add DPRES to your AUTOEXEC.BAT file so that it is loaded each
  204.      time your system is loaded.
  205.  
  206.      As an example, on our systems we would add:
  207.  
  208.           D:\DOS\TLA\DPRES
  209.  
  210.      to the AUTOEXEC.BAT file.  Each time DPRES loads, it will
  211.      identify itself.  You can suppress these messages by substituting
  212.      the following command:
  213.  
  214.           D:\DOS\TLA\DPRES > NUL
  215.  
  216.      to take the normal console output and redirect it.
  217.  
  218.  
  219. ERROR MESSAGES:
  220.  
  221. This facility issues the following error messages:
  222.  
  223.      DPP: All resident stack elements used.
  224.  
  225.                       DP, DPUSH.  An attempt was made to add the
  226.                       ninth drive-directory to the resident stack. 
  227.                       There is space allocated for only eight
  228.                       elements.  The request was ignored.  You probably
  229.                       need to purge the resident stack with a DPOPALL
  230.                       or DP /CLEAR command.
  231.                     
  232.      DPP: Error popping directory off resident stack.
  233.  
  234.                       DP, DPOP or DPOPALL.  An error occurred while
  235.                       removing a drive-directory from the resident
  236.                       stack.  Two possibilities exist:
  237.  
  238.                       either:
  239.  
  240.                       Some other process on your system has
  241.                       overwritten the DPRES area of your memory.
  242.  
  243.                       or:
  244.  
  245.                       You DPUSHed a drive-directory, renamed or
  246.                       deleted the directory on your disk and then
  247.                       issued a DPOP.  Since the directory no longer
  248.                       exists or has the same name, it is not possible
  249.                       to change the current drive-directory to its
  250.                       value.
  251.   
  252.      DPP: Error reading current directory.
  253.      
  254.                       DP or DPUSH.  An error occurred while attempting
  255.                       to read the current directory.  The resident
  256.                       stack is unchanged.  The request is ignored.
  257.  
  258.      DPP: Invalid number of parameters specified.
  259.  
  260.                       DP.  An incorrect number of parameters was
  261.                       specified.  The request was ignored. 
  262.  
  263.      DPP: No drive-directory in resident stack.
  264.                   
  265.                       DP, DPOP or DPOPALL.  A request to pop an entry
  266.                       from the resident stack could not be serviced
  267.                       because there were no active elements in the
  268.                       stack.  Put another way, you issued more DPOPs
  269.                       then DPUSHs.
  270.  
  271.      GO: Invalid number of parameters specified.
  272.  
  273.                       GO.  An incorrect number of parameters was
  274.                       specified.  The request was ignored. 
  275.  
  276.  
  277. SHAREWARE:
  278.       
  279. This software is provided as shareware for your evaluation, use, and
  280. financial contribution.  This software has not been placed in the
  281. public domain.
  282.  
  283. If you use this software, and live outside Massachusetts, please send
  284. a payment of $10.00 to:
  285.  
  286.      Thom Little Associates
  287.      Product Support
  288.      P.O. Box 1901
  289.      Boston, MA  02205-1901
  290.  
  291.      Voice ......... 617.227.4644
  292.      Compuserve .... 70724,71 (Thom Little)
  293.      Channel One ... Thom Little
  294.  
  295. (If you reside in Massachusetts please include Massachusetts state
  296. tax of $.50 for a total of $10.50.)
  297. 
  298. Copyright 1986-1992 ∙Thom∙Little∙Associates∙ all rights reserved.
  299.  
  300.  
  301. DISCLAIMER:
  302.  
  303. ∙Thom∙Little∙Associates∙ disclaims all warranties as to this software,
  304. whether express or implied, including without limitation any implied
  305. warranties of merchantability, fitness for a particular purpose,
  306. functionality or data integrity or protection.
  307.  
  308.  
  309. HISTORY:
  310.  
  311. 01-01-92  Version 3.00 first shareware release to public.
  312.