home *** CD-ROM | disk | FTP | other *** search
/ DOS Wares / doswares.zip / doswares / UTILS / TOOLS / APATH22.ZIP / APATH.DOC < prev    next >
Encoding:
Text File  |  1992-03-29  |  10.5 KB  |  215 lines
  1. APATH           Copyright (c) 1992    Walt Stoneburner
  2. v2.2            All Rights Reserved.  Wizard Workshop and Company
  3.  
  4. Altering the current PATH can become a pain at times, especially when the
  5. changes are minor.  APATH was designed to allow PATH manipulations quickly
  6. and easily using little overhead.
  7.  
  8. APATH is ideal for modifying the path in make files, batch files, LAN 
  9. administration login/logout batch files, and the command line without 
  10. the excess baggage of saving and restoring the environment variables.
  11.  
  12. By being able to reduce extra paths in the PATH environment variable
  13. until they are needed should allow quicker searching of the path.
  14. Software that requires its directory be in the path can be activated by
  15. a batch file which makes the path addition, runs the software, and
  16. removes it without accidently restoring an invalidated path.
  17.  
  18.  
  19. Usage:
  20.         APATH [/M] [+|-]path[;path...]
  21.  
  22.                 /M              Changes affect the master environement.
  23.                                 No parameter changes parent's environment.
  24.  
  25.                 path            Any directory path.  Multiple paths may be
  26.                                 specified separated by semicolons.  If the
  27.                                 path is not  already part of  the  PATH it 
  28.                                 will be prepended to the front.  If it is,
  29.                                 the path addition will be ignored.
  30.  
  31.                 +path           Same as above, but the specified path will
  32.                                 be appended to the PATH variable's end.
  33.  
  34.                 -path           The specified path will  be  removed  from
  35.                                 the PATH variable.  If the path can not be
  36.                                 found, the deletion will be ignored.
  37.  
  38.         Multiple prepends, appends, and deletes may be specified on a line.
  39.         Only the first character of the path sequences may be a - or +.
  40.  
  41. Examples:
  42.         APATH C:\UTIL                   Prepend C:\UTIL to front of PATH.
  43.  
  44.         APATH +C:\UTIL                  Append C:\UTIL to end of PATH.
  45.  
  46.         APATH -C:\UTIL                  Remove C:\UTIL from PATH.
  47.  
  48.  
  49.         APATH /M C:\UTIL;C:\TMP         Prepend C:\UTIL and C:\TMP to PATH
  50.                                         in master environment only.
  51.  
  52.         APATH +C:\UTIL;C:\BIN -D:\TMP F:\USR\LIB
  53.                                         Append C:\UTIL and C:\BIN,
  54.                                         Delete D:\TMP, and
  55.                                         Prepend F:\USR\LIB to PATH.
  56.  
  57. Note:   The prepend argment will affectively reverse the order of the
  58.         paths specified.   e.g.  APATH A;B;C  will make  PATH=C;B;A
  59.         This is because A is prepended, then B is prepended in front
  60.         of the A, and finally C is prepended infront of the B.
  61.  
  62.         Using the + to append will produce arguments appended to the
  63.         path in the same order they are specified in.
  64.  
  65.         
  66.  
  67.  
  68. Version History
  69.  
  70.   v1.0  APATH developed an extensive testing and multiple revisions before
  71.         first public release.  Appends, Deletes [-], and Prepends [+] paths
  72.         to the PATH environment variable.  Modifies the parent environment.
  73.         APATH was written completely in assembly language in an effort to
  74.         keep size down and speed up.  
  75.   v2.0  Reversed meaning of + to mean append and made default prepend.
  76.   v2.1  Reduced code size 800 bytes.
  77.   v2.2  Added /M for master environment.  Reduced source code 15 bytes.
  78.         Bug fix for empty environment.
  79.  
  80.  
  81. Thank You List
  82.   Many thanks to Doug "Power User" Austin who beta-tested the software,
  83.   gave me better insight on making the user interface better, corrected
  84.   some documentation errors, and laughed at the jokes in the documentation
  85.   without a lot of prodding.  He has the talent for finding the non-trivial-
  86.   obvious mistakes.
  87.  
  88.  
  89.                                       
  90. Disclaimer & Other Legal Stuff
  91.  
  92.   NO LIABILITY FOR CONSEQUENTIAL DAMAGES
  93.   In no event whatsoever shall the author, suppliers of APATH, or basically
  94.   anyone in the universe, be held liable for any damages whatsoever 
  95.   (including, without limitation to, damages for loss of business profits,
  96.   business interruption, loss of business information, other pecuniary
  97.   loss, paper cuts, or the destruction of the galaxy) arising out of the use,
  98.   abuse, misuse, or inability to use this program, even if the author has 
  99.   been advised of the possibility of such damages.  If you are uncomfortable
  100.   with the above, please do not use the program or send any money.  Look,
  101.   this program was written for personal use; it worked well for me, so I'm
  102.   virtually giving it away; I don't want my tush sued off because I was
  103.   just being generous.
  104.  
  105.   NO WARRANTY EXPRESSED OR IMPLIED
  106.   While you are free to try out the software for 30 days, do not send any
  107.   money until you are satisfied with the program.  Monies can not be 
  108.   returned.  No warranty or guarantee is provided that the software will
  109.   operate as stated in this manual.
  110.  
  111.   GRANT OF LICENSE
  112.   After sending the registration card below, you are free to use APATH
  113.   on as many personal machines as you can possibly get your hands on from
  114.   now until the Advent of Christ.  Businesses are site licensed for a finite
  115.   number of copies executing simultaneously on different machines (see 
  116.   registration card).
  117.  
  118.   COPYRIGHT
  119.   This software is owned by Wizard Workshop and Company.  You are free to
  120.   modify and patch this version to suit your needs.  However, please do not
  121.   redistribute the patched version; you may redistribute the patch and/or
  122.   instructions for making the patch.  We would prefer people obtained clean
  123.   copies in the event we choose to offer technical support.
  124.  
  125.   TECHNICAL SUPPORT
  126.   We make no claims or promises for offering technical support.  However,
  127.   if you write us, we'll consider it.  If you bribe us, we'll take you
  128.   very seriously.
  129.  
  130.   OTHER RESTRICTIONS
  131.   Don't hurt anyone.  It isn't nice.  Look both ways before crossing the
  132.   street.  Kids, don't smoke or do drugs.  And if you're gonna drink and
  133.   drive, get your parents' permission first.
  134.  
  135.   CUSTOMER REMEDIES
  136.   Take an aspirin.  Short from that, we can't help you.
  137.   
  138.  
  139.  
  140. Contact Us Via EMail
  141.  
  142.   If you'd like to write and try to weasel support, technical information,
  143.   or source code from the author, he can -indirectly- be reached by the
  144.   following EMail addresses.  
  145.  
  146.   Please state clearly that your message pertains to APATH (give the
  147.   version number).  These friendly people below will get the message to me
  148.   one way or another and are not necessarily responsible for answering
  149.   your pleas.  They are certainly not responsible if anything goes wrong.
  150.  
  151.     CompuServe:   70651,2707  or  72137,1152
  152.     Internet:     70651.2707@cis.com  or  psw@mitre.org
  153.     GEnie:        AUSI-DGATE  or  A.GARIES
  154.  
  155.         
  156. Registration
  157.  
  158.   If you are an individual using APATH for personal use, you're in luck...
  159.   Using APATH will cost you nothing, however, I would like you to send the
  160.   registration form below in anyhow.  By not charging a fee to individuals,
  161.   I'm hopeful you'll feel more inclined to let me know you are using
  162.   something I've written, and therefore I should devote more free time to
  163.   projects like this.
  164.  
  165.   If you are a company, well... you're not as lucky as the individuals above.
  166.   However.  I know that you'd most likely want a site license or something
  167.   like that.  And I'm willing to do that... cheap.  Very cheap.
  168.  
  169.   So... on with the paper work.
  170.  
  171.                 Please fill out below and send to:
  172.  
  173.                         Wizard Workshop and Company
  174.                         APATH Registration
  175.                         9307 Lundy Court
  176.                         Burke, Virginia  22015
  177.  
  178.  
  179. +---------------------------------------------------------------------------+
  180. |                                                                           |
  181. | Name:  ________________________________    [ ]  My personal use,          |
  182. |                                                 no charge.  Thanks!       |
  183. | Company:  _____________________________                                   |
  184. |                                            [ ]  My personal use; I've     |
  185. | Address:  _____________________________         enclosed $5 or more, send |
  186. |                                                 commented source code     |
  187. |           _____________________________                                   |
  188. |                                            [ ]  Company site license      |
  189. |           _____________________________          $15 :  1 - 19 users      |
  190. |                                                  $25 : 20 - 49 users      |
  191. | Phone:    _____________________________          $50 : 50 - infinity      |
  192. | Optional  [ Circle:  DAY  NIGHT  WORK ]                                   |
  193. |                                                                           |
  194. | [ ]  We would like to distribute APATH with our products.  Enclosed is    |
  195. |      $100 which gives us an infinite site license for this product and    |
  196. |      your permission to distribute this and future upgrades of APATH as   |
  197. |      they become publicly accessible.                                     |
  198. |                                                                           |
  199. | ( )  I am interested in other        ( )  I would be interested in Beta   |
  200. |      things you develop[ed] when          testing software as it is being |
  201. |      they become available.               developed.                      |
  202. |                                                                           |
  203. | EMail Address:  ________________________________________________________  |
  204. |                                                                           |
  205. | Comments / How Are You Using APATH:                                       |
  206. |                                                                           |
  207. | ________________________________________________________________________  |
  208. |                                                                           |
  209. | ________________________________________________________________________  |
  210. |                                                                           |
  211. | ________________________________________________________________________  |
  212. |                                                                           |
  213. +---------------------------------------------------------------------------+
  214.  
  215.