home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS - Coast to Coast / simteldosarchivecoasttocoast.iso / pathutil / mp.zip / MP.MAN < prev   
Text File  |  1992-08-30  |  3KB  |  71 lines
  1.                            MP -- Modify Path
  2.  
  3. USAGE
  4.  
  5.     MP [-{p|a} newpathnode | -r oldpathnode [newpathnode] ]*
  6.  
  7.  
  8. FUNCTION
  9.  
  10.     MP modifies the working path for MS DOS environments by
  11. prepending ("-p") or appending ("-a") a new path node to an existing path
  12. environment or by replacing ("-r") an old path node ("oldpathnode") with
  13. a new path node ("newpathnode") within the existing path.  For the -r
  14. option, the field specifying "newpathnode" can be empty, thus deleting
  15. "oldpathnode" from the search path entirely.
  16.  
  17.     Note that for the -r switch, the new path node that might replace 
  18. the old path node in the PATH list may be omitted: if so, the old path node
  19. is removed from the PATH list but is not replaced.  Since switches are 
  20. processed in the order entered, a -r followed by a -p or -a can be used
  21. to move a node from the interior of a PATH list to the beginning or end
  22. of that list.
  23.  
  24.     The path node names are case sensitive!  
  25.  
  26.     This program operates on the PARENT process environment, thus
  27. eliminating the requirement to use a batch file or enter a complete new
  28. path specification to make minor modifications to the working path.
  29.  
  30.  
  31. IMPLEMENTATION
  32.  
  33.     MP copies the environment block from the parent process to local
  34. strings, modifies the local string for PATH, then copies the complete
  35. set of environment strings back to the parent environment block.
  36.  
  37.  
  38. ERROR CONDITIONS
  39.  
  40.     MP will report an error and leave the path unmodified if there
  41. is insufficient room in the environment block for the modified PATH
  42. environment variable.  In this situation, the path could not be
  43. modified even at the command level.  To prepare for future use of MP or
  44. changes to the path by other methods in this case, increase the size of
  45. the environment block by modifying the CONFIG.SYS file line specifying 
  46.  
  47.     COMSPEC=dd:COMMAND.COM/e:nnn
  48.  
  49. to increase (or specify) the /e: parameter for the size of the
  50. environment block.
  51.  
  52.     MP also reports if a switch is given with no nodename to process, if 
  53. an invalid switch is given, or if switches are not prefixed with '-'.
  54.  
  55.  
  56. LANGUAGE AND COMPATIBILITY
  57.  
  58.     MP is written in TURBOC and has been tested with DOS 3.3, DOS
  59. 4.01, and DOS 5.0.  Since it does not use DOS systems calls to effect
  60. the modifications (and cannot, since DOS does not provide a mechanism
  61. for a child process to change the environment block of its parent), MP
  62. may be incompatible with future versions of DOS.
  63.  
  64.  
  65. AUTHOR
  66.  
  67.     MP was written by H. D. Todd, Wesleyan University, December,
  68. 1990 and is supplied in source-code form.  The author would appreciate
  69. receiving bug reports and modifications (send to
  70. HDTodd@eagle.wesleyan.edu or HDTodd@wesleyan.bitnet).
  71.