home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / UTILITY / DIR / PUSH_POP.ZIP / PUSHD.DOC < prev    next >
Encoding:
Text File  |  1990-07-23  |  3.3 KB  |  83 lines

  1.     PUSHD version 1.2
  2.  
  3.     Usage:
  4.         PUSHD directory
  5.          Will push the current directory onto the directory stack
  6.          if there is a location available and changes to the current
  7.          directory to the specified parameter.
  8.         PUSHD 
  9.          Will change the current directory to the directory stored
  10.          in the top of the stack and will place the current directory
  11.          on the top of the stack.
  12.         PUSHD +n
  13.          Will change the current directory to the directory stored
  14.          in stack location n, with 1 being the bottom of the stack
  15.           and 6 being the top.  The stack will be compressed to remove
  16.          any empty space and the current directory will be stored 
  17.          on top of the stack.
  18.     Purpose: This program will store directories in a memory-resident
  19.         area and change to a specified directory, so that the
  20.         user may switch back to a previous directory without having
  21.         to either know or to type in the required directory.  If the 
  22.         program terminates abnormally an error message will be
  23.         printed to the standard error.
  24.     Requirements:
  25.         PUSHD v. 1.2  will work with POPD v. 1.2 and DIRS v. 1.1b.
  26.     Notes:
  27.         PUSHD requires 2016 bytes free memory to run.
  28.         If PUSHD was not previously loaded into memory, due to
  29.          not use or abnormal termination, the program will now be 
  30.          loaded with a reduction of memory of 1024 bytes.  This
  31.          includes the storage space required for the stack and
  32.          the new interrupt 13 handler.
  33.     Error Codes:
  34.         0) Successful completion.
  35.           249) Error popping directory off stack.
  36.           250) Error pushing current directory.
  37.           251) Directory Stack is full.
  38.           252) Error changing to directory given on command line.
  39.           253) Command Line parameter exceeds Directory Stack depth.
  40.           254) Illegal Characters on the Command Line.
  41.           255) Command Line parameter not in valid directory range (1-6).
  42.     Version changes:
  43.         PUSHD v. 1.2:    July 21, 1990.
  44.             coded in Toad Hall tweaks and suggestions (much 
  45.              thanks to David Kirschbaum).
  46.         PUSHD v. 1.1:    July 14, 1990.
  47.             added "+n" option.
  48.             added change to parameter option.
  49.             changed no parameter option to switch current and
  50.              top directories.
  51.             changed hooked interrupt to 13 from 16.
  52.             added error codes for abnormal termination.
  53.             changed writes from vector 9 to vector 40h of 
  54.              int 21h.
  55.             changed program termination from int 20h to vector
  56.              4Cxxh int 21h, where xx represents the error code
  57.              generated.
  58.             removed stack wrap around.
  59.         PUSHDIR v. 1.0: Copyright 1986, Ziff-Davis Publishing Co.
  60.             From PC Magazine, May 27, 1986
  61.             No changes.
  62.     Future Enhancements:
  63.         1) Change the "n" parameters so that it refers to the
  64.          top of the stack, not the bottom (RELATIVE from the top
  65.          NOT ABSOLUTE from the bottom).
  66.         2) Make program an .EXE file.
  67.         3) Remove extra push/pop commands.
  68.         4) Fix up various hacks.
  69.         5) Correct error caused by 3 or more blanks at end of
  70.          command line tail.
  71.         6) Add a help option, ?, from the command line.
  72.         7) have "signature" loaded into memory so that programs such
  73.          as "POPDROP" can identify the stack as resident.
  74.  
  75.     Created by:
  76.       (from ideas based in UNIX and from PC Magazine's POPDIR.COM)
  77.         William P. Sarra
  78.             CIS:71041,347
  79.             arpa: sarra@TOPAZ.RUTGERS.EDU
  80.     uucp: ...{ames,cbosgd, harvard, moss}!rutgers!topaz.rutgers.edu!sarra
  81.  
  82.  
  83.