home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / utility / pm35.zip / PM.DOC < prev    next >
Text File  |  1993-05-09  |  46KB  |  1,252 lines

  1.  
  2.  
  3.                           █▀▀▀█
  4.                           █▄▄▄█            ▄  ▄
  5.                           █     █▀▀█ ▀▀█▀▀ █▄▄█
  6.                           █     █▀▀█   █   █  █
  7.  
  8.                     █▀▀█▀▀█
  9.                     █  █  █ █▀▀█ █▀▀▀ ▀▀█▀▀ █▀▀▀ █▀▀█
  10.                     █  █  █ █▀▀█ ▀▀▀█   █   █▀▀▀ █▀█▀
  11.                     ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█   ▀   ▀▀▀▀ ▀ ▀▀▀▀
  12.  
  13.  
  14.                                ───╖     ╓───
  15.                                ───╢     ╙──╖
  16.                                ───╜    ───╜
  17.  
  18.  
  19.                    *-*  The Ultimate Path Utility *-*
  20.                             David Smith, 1993
  21.  
  22.  
  23.  
  24.  
  25. ============== QUICK START ===================================================
  26.  
  27.         Path Master allows you to configure 20 of your favorite paths, then
  28.         choose them later from a menu.
  29.  
  30.         Type:   PM      to start Path Master.  You will immediately pop
  31.                         into an edit screen.  Type in a few of your
  32.                         favorite paths, ie:   C:\UTILS;C:\DOS;C:\
  33.  
  34.                         Press the [F10] key to save and exit.  Later, when
  35.                         you want to change your path, instead of typing
  36.                         in the whole thing on the command line, just
  37.                         type:     PM
  38.  
  39.                         The paths you saved will pop up on a colorful menu,
  40.                         and you can choose one.  Just press [ENTER] to
  41.                         select your new path.
  42.  
  43.                         For more information on the DOS PATH, consult your
  44.                         DOS manual.
  45.  
  46. ==============================================================================
  47.  
  48.         Path Master 3.5
  49.  
  50.         Usage:   PM  [path/option] [path]
  51.  
  52.  
  53.  
  54.  
  55.  
  56. == OPTIONS: ===================================================================
  57.  
  58.  
  59.    PM                 Pulls up a path Menu.  Simply choose a path, then
  60.                       press [ENTER] to set your new path.  Press [F1] for
  61.                       a help screen.
  62.  
  63.  
  64.    PM /?              Help screen.  Shows help about PATH MASTER.
  65.  
  66.  
  67.    PM /E              Allows editing Menu paths.  You can fill in up to 20
  68.                       paths to choose from.  The usual arrows/insert/ESC
  69.                       editing keys are in effect.  Press [F10] to save your
  70.                       paths and exit to DOS.
  71.  
  72.  
  73.    PM /Q              Quick edit your path.  A window will appear with your
  74.                       current path.  Simply edit this path, then press [F10]
  75.                       to save and exit.
  76.  
  77.  
  78.    PM /INFO           Advanced path information.  This shows several pages of
  79.                       info on the path, stretching the environment, etc.
  80.                       Press [ESC] to exit, PgDn, PgUp, or Arrow keys to scroll
  81.                       through text.
  82.  
  83.  
  84.    PM /SIZE           Show environment size and info.  This shows a graph of
  85.                       current env. plus more.
  86.  
  87.  
  88.    PM /S              Shows current path.  This simply shows you what your
  89.                       current path is.
  90.  
  91.  
  92.    PM /LIST           Lists all the directories in your path.
  93.  
  94.  
  95.    PM [path]          Insert new path into environment.  This totally replaces
  96.                       your path with a new one.  If you only want to temporarily
  97.                       add a directory, use /TMP instead.
  98.  
  99.  
  100.    PM /AE             Add directory to end of path.  A window will appear
  101.                       asking you what directory to add.  Your directory will
  102.                       be placed as the LAST dir on your path.
  103.  
  104.  
  105.    PM /AB             Add directory to beginning of path.  A window will appear
  106.                       asking you what directory to add.  Your directory will
  107.                       be placed as the FIRST dir on your path.
  108.  
  109.  
  110.    PM /DEL            Delete a directory from path.  A window will appear
  111.                       asking which dir to delete.
  112.  
  113.  
  114.    PM /TMP [path]     Create temporary path.  The directory you specify
  115.                       in [path] is added to your current path.  To restore
  116.                       your old path, type:  OLD.
  117.  
  118.                       Example:    PM /tmp c:\utils  temporarily adds c:\utils
  119.                                                     to your current path.
  120.                                                     To restore the old
  121.                                                     path, type: OLD.
  122.  
  123.                                   PM /tmp \dos      temporarily adds \dos
  124.                                                     to your current path.
  125.  
  126.  
  127.    PM /ACT            Put path into active environment.  For further explanation
  128.                       of ACTIVE vs. MASTER environments, see below.
  129.  
  130.  
  131.    PM [dir] [pos]     Add directory at position.  This adds a directory [dir]
  132.                       to any position on your path.  You can specify the dir
  133.                       to be your first, second, third, ...  directory on the
  134.                       path.
  135.  
  136.                       Example:    PM  c:\utils  3  makes c:\utils the third
  137.                                                    dir on your path.
  138.  
  139.                                   PM  \dos  5      makes \dos the fifth dir
  140.                                                    on your path.
  141.  
  142.  
  143.    PM /F:[file]       Use alternate config file.  PATH MASTER stores your
  144.                       favorite paths in a file called \PATH.CFG.  This is
  145.                       stored in your root directory.
  146.                       If you have more than one set of paths, or you want to
  147.                       use another file instead of PATH.CFG, use this option.
  148.  
  149.                       Example:    PM  /F:myconfig  uses MYCONFIG to store your
  150.                                                    paths
  151.  
  152.                                   PM  /F:path.1    uses PATH.1 to store your
  153.                                                    paths
  154.  
  155.                       NOTE: Path configurations are limited only to disk space
  156.                             when using this option.  Roomates or office-mates
  157.                             can share the same computer, and both have different
  158.                             configurations for PATH MASTER.
  159.                             Or, if you own a monster hard drive (1 gig) with
  160.                             several hundred directories, you can have unlimited
  161.                             configured paths.
  162.  
  163.  
  164.    PM /E:[file]       Obviously, you need to edit any config file you use.
  165.                       If you choose to have a different file other than the
  166.                       default \PATH.CFG, then you must use this option to
  167.                       set up your directories.  This is exactly the same
  168.                       as PM /E, but you edit any config file you want.
  169.                       For example:      PM /E:path.1
  170.                       will edit PATH.1 for later use.  If you want to pull
  171.                       these new paths for picking, type:    PM /F:path.1
  172.  
  173.  
  174.    PM /PB:new.bat     (Pick and Batch) Allows you to pick a path from
  175.                       your menu, then write it to a batch file rather
  176.                       than placing it into the environment.
  177.                       This is good when you have a favorite path, and
  178.                       need a batch file to create it, rather than starting
  179.                       up PATH MASTER every time.
  180.  
  181.                       Example:    PM  /PB:mine.bat  creates MINE.BAT when you
  182.                                                     pick a path from the menu.
  183.                                                     You can later use to change
  184.                                                     your path.
  185.  
  186.                                   PM  /PB:new.bat   creates NEW.BAT when you
  187.                                                     pick a path from the menu.
  188.                                                     You can later use to change
  189.                                                     your path.
  190.  
  191.  
  192.    PM /WB:new.bat     (Write Batch) Allows placing the current path into
  193.                       a batch file for later use.  This is similar to
  194.                       /PB:  except you do NOT choose the path from the
  195.                       menu.  Instead, PATH MASTER pulls the current path
  196.                       from the environment, then writes it to a batch
  197.                       file.
  198.  
  199.  
  200.    PM /DEFAULT=#      Starts the menu, and points to the path number
  201.                       specified.  Normally, when PATH MASTER starts,
  202.                       it points to the first path, and allows you to
  203.                       scroll through the list using the arrow keys.
  204.                       If you start PATH MASTER, and always seem to choose
  205.                       the same path, then set the DEFAULT to whatever
  206.                       path number you always choose.  This way, you do
  207.                       not have to scroll around the list everytime.
  208.  
  209.  
  210.    PM /BIG [file]     Pick from a list of BIGGER paths.
  211.                       1.  Create a text file containing up to 20 paths,
  212.                           using your favorite editor.
  213.                           Each path can be up to 150 characters long.
  214.                       2.  Type:  PM /BIG [file]
  215.                           Your new text file is imported into PATH MASTER,
  216.                           and you can choose one to stuff into the
  217.                           environment.
  218.                       3.  For examples of a valid path, consult your DOS
  219.                           manual.
  220.  
  221.                       If you like paths longer than 80 characters,
  222.                       this is great!
  223.  
  224.                       If your paths take up more than one screen, scroll
  225.                       right using the RIGHT arrow key to reveal the remainder
  226.                       of the paths.
  227.                       Simply choose a path by highlighting it, then
  228.                       press [ENTER] to save.
  229.  
  230.                       NOTE:  To store a path longer than 127 characters,
  231.                              you must expand your environment.  See
  232.                              EXPAND YOUR ENVIRONMENT section below.
  233.  
  234.                              Also, realize that your normal \PATH.CFG file
  235.                              is different from the file you import here.
  236.                              Your text file CANNOT be imported into any
  237.                              other PATH MASTER functions.  If you want to
  238.                              edit these paths, use your own text editor.
  239.  
  240.  
  241.    PM /STACK          Pick a path from the menu, and stack it on top of
  242.                       current path.
  243.  
  244.                       If you like a long path, this is great.  Path Master is
  245.                       started, and you choose a path from the menu as usual.
  246.                       The path you choose, however, is added onto the end of
  247.                       your current path.
  248.             Example:
  249.                       If you current path is:  C:\UTILS;C:\DOS
  250.  
  251.                       and you choose the path: C:\TEMP;D:\  from the menu,
  252.                       then your path becomes:  C:\UTILS;C:\DOS;C:\TEMP;D:\
  253.  
  254.                NOTE:  If you create a path longer than 127 bytes, you must
  255.                       first expand your environment.  See the EXPAND YOUR
  256.                       ENVIRONMENT section below for details.
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.           ╓───────────────────────────────────────────────────────────╖
  272.           ║            THE PATH MASTER    "PM"     VARIABLE           ║
  273.           ╙───────────────────────────────────────────────────────────╜
  274.  
  275.  
  276.  
  277.  
  278.         The environmental variable PM allows you to set preferences
  279.         in PATH MASTER.  For example, if you have a monochrome screen,
  280.         then you can type:
  281.                                 SET PM=MNO
  282.  
  283.         on the command line, which customizes PATH MASTER's operation.
  284.         It's best to put this line in your autoexec.bat file, to
  285.         ensure PATH MASTER runs the way you'd like.
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.    VALID PREFERENCES ARE:
  293.  
  294.  
  295.    ERR       show DOS ERRorlevel on exit
  296.                 This allows you to see how PATH MASTER exited, and
  297.                 find errors in some cases.
  298.  
  299.    MNO       use MoNOchrome screen writes
  300.                 PATH MASTER normally assumes EGA/VGA, however if you
  301.                 operate a XT or LCD screen, use this option.
  302.  
  303.    SPH       Show new PatH on exit
  304.                 My favorite preference, so that I can see what
  305.                 PATH MASTER did to the path.
  306.  
  307.    SST       Show STatistics on exit
  308.                 This is similar to the /SIZE switch, but without
  309.                 the colorful graph.
  310.  
  311.    CLR       CLeaR screen after exit
  312.                 PATH MASTER normally stores the screen position, writes
  313.                 a window to the screen, then places the cursor back
  314.                 where it was, and include a carriage return.  This allows
  315.                 a full screen clear before exiting.
  316.  
  317.    DZ1       show DeZign #1 as window background
  318.  
  319.    DZ2       show DeZign #2 as window background
  320.  
  321.    DZ3       show DeZign #3 as window background
  322.  
  323.    NDZ       no DeZign in background
  324.                 Skip the designs completely.
  325.  
  326.    SND       enable SouNDs
  327.                 Turns on the cute little sounds.
  328.  
  329.    NEA       No check Existence of dir before Adding
  330.                 When you add a directory to your path, PATH MASTER
  331.                 checks the current drive to ensure that directory
  332.                 exists.  This turns the checking off.
  333.  
  334.    NED       No check Existence of dir before Delete
  335.                 When you delete a directory to your path, PATH MASTER
  336.                 checks the current path to ensure that directory
  337.                 exists on the path.  This turns the checking off.
  338.  
  339.    NMS       No MouSe  (disable mouse)
  340.  
  341.    PRM       make OLD.BAT PeRManent  (don't delete)
  342.                 When using the /TMP option, PATH MASTER creates a batch
  343.                 file (OLD.BAT) that restores the path back to normal.
  344.                 By default, OLD.BAT deletes itself so that you won't have
  345.                 100 OLD.BATs running around your hard disk.
  346.                 This preference turns the deleting off.
  347.  
  348.    OLD       create OLD.BAT every time path is changed
  349.                 Normally, OLD.BAT is only created when using the /TMP
  350.                 option.  This tells PATH MASTER to create OLD.BAT
  351.                 every time the path is changed, so that you can easily
  352.                 restore it later.
  353.  
  354.    EXP       disable EXPiration message
  355.                 If PATH MASTER gets rather old (usually 1.5 years), it
  356.                 displays a message suggesting you get an update.
  357.                 GO AHEAD AND GET THE UPDATE!!  Path Master is constantly
  358.                 improving, evolving.  You probably have an ancient version,
  359.                 so get the update.... it's free.
  360.                 But if you really want to, this turns that message off.
  361.  
  362.    LST       LiST paths on exit
  363.                 My other favorite preference.  This shows all your directories
  364.                 on your new path once PATH MASTER exits.
  365.  
  366.    ACT       always use ACTive environment for path
  367.                 This tells PATH MASTER to write your new path to the
  368.                 active environment.  For further explanation of active vs.
  369.                 master environments, see below.
  370.  
  371.    MAS       always use MASter environment for path
  372.                 This tells PATH MASTER to write your new path to the
  373.                 master environment.  For further explanation of active vs.
  374.                 master environments, see below.
  375.  
  376.  
  377.  
  378.  ╒════════════════════════════════════════════════════════════════════╕
  379.  │      Preferences should be separated by commas.  For example:      │
  380.  │                                                                    │
  381.  │      SET PM=SND,MAS,EXP                                            │
  382.  │                                                                    │
  383.  │      SET PM=ACT,NEA,LST,NMS                                        │
  384.  ╘════════════════════════════════════════════════════════════════════╛
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398. -------  WHAT'S NEW 3.5 -----------------------------------------------
  399.  
  400.  
  401.  
  402.  
  403.    Path Master now searches the PATH for its help file:  PM.HLP
  404.  
  405.         EXIST.EXE       searches PATH for a file (good batch file util)
  406.  
  407.         PMCNVRT.EXE     converts Path Master normal config binary
  408.                         files to text files that can be imported
  409.                         using the /BIG option
  410.  
  411.         SAVE.COM        utility to save current environment into a
  412.                         batch file called: MINE.BAT that can be
  413.                         later run to restore all environmental variables
  414.  
  415.  
  416.  
  417.  
  418. -----------------------------------------------------------------------
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.   WHAT IS PATH MASTER ?
  427.  
  428.         Changing your path is a pain.  Mainly because you must type
  429. the ENTIRE thing in from scratch, or make 20 different batch files
  430. that change your path that clutter up your hard drive.
  431.  
  432.  
  433.     PATH MASTER solves this by allowing you to:
  434.  
  435.         1) Choose your path from a menu, even a path longer
  436.            than 127 CHARACTERS!
  437.  
  438.         2) Totally configure your menu, and change a path quickly
  439.            and easily.
  440.  
  441.         3) Add or delete a directory from the path.
  442.  
  443.         4) Change your path on the command line.
  444.  
  445.         5) Use your mouse to control PATHMASTER
  446.  
  447.         6) Learn about the PATH, how it works, and how
  448.            to both expand and locate it.
  449.  
  450.         7) Showing you exactly how much environment you
  451.            have left, and how much has been used.
  452.  
  453.         8) Allow setting preferences in environmental
  454.            variable.
  455.  
  456.         9) Place new directory at any position within
  457.            the path.
  458.  
  459.        10) Create a temporary path, then restore it without
  460.            re-typing or remembering the original path.
  461.  
  462.        11) Plus many more options and setting your preferences
  463.            by using a convenient environmental variable.
  464.  
  465.  
  466.  
  467.  
  468.  
  469. ==== HOW TO OPERATE PATH MASTER ===============================================
  470.  
  471.         To begin, you must configure your favorite paths into the
  472.         configuration file that will be stored in your root
  473.         directory.
  474.  
  475.         Type: PM /E         {edit the configurations}
  476.  
  477.         You have 20 blanks that you may enter paths into.  To move around,
  478.         press [ENTER] after typing a path, or use the arrow keys.
  479.         Regular editing keys are valid in EDIT mode:
  480.         HOME, END, INSERT, DELETE, PgUp, PgDn, ENTER, BACKSPACE
  481.  
  482.         Examples of a valid paths:
  483.  
  484.         C:\DOS;C:\UTILS;C:\TURBO\BIN\INCLUDE
  485.         C:\UTILS
  486.         A:\DOS;C:\PCPLUS;C:\WP51
  487.         D:\STACKER;C:\DOS
  488.  
  489.         (Notice that a valid path consists of NO SPACES, a semicolon
  490.          between the directories, and does NOT include the "PATH="
  491.          statement.)
  492.  
  493.         Fill it up with up to 20 configurations, then press [F10] to
  494.         save and quit.
  495.  
  496.                 Press [F1] for a help screen.
  497.  
  498.         If you are using a MOUSE, ensure your mouse driver is installed,
  499.         and move your mouse up and down to choose from the menu or move
  500.         around the configuration editor.  Press the LEFT button to select
  501.         an item, or press the RIGHT button to escape PathMaster.
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509. ==== USING THE MENU INTERFACE =================================================
  510.  
  511.         Once you're configured, just type: PM    to pull up the
  512.         menu.  Use UP/DOWN arrows, PgUp, PgDn, Home, End to move
  513.         around, then press [ENTER] to choose a new path.
  514.  
  515.         Press [F1] for a help screen.
  516.  
  517.  
  518.  
  519.  
  520.  
  521. ==== USING OTHER OPTIONS ======================================================
  522.  
  523.         On the command line, if you want to remove a directory
  524.         from your path, type: PM /DEL
  525.  
  526.         If you want to add a directory to the END of your
  527.         current path, type: PM /AE
  528.  
  529.         If you want to add a directory to the BEGINNING of your
  530.         current path, type: PM /AB
  531.  
  532.         For a listing of the current path, type: PM /S
  533.  
  534.         To place the path in the Active Environment, instead of
  535.         the Master Environment, type: PM /ACT
  536.  
  537.         To create a totally new path, type: PM [path]
  538.  
  539.                 Press [F1] for a help screen.
  540.  
  541.         To see advanced information on the PATH, how it works,
  542.         how to alter and expand it, etc.  use the /INFO switch.
  543.         This pulls up 15 pages of graphical information.
  544.                 Use up/down arrows or PageUp/PageDown keys
  545.                 to move around the info.  When you are done
  546.                 reading, press [ESC] to exit.
  547.  
  548.         To see the current environment, how much you have used,
  549.         how much free, and a bar graph showing this information,
  550.         use the /SIZE switch.  A box will appear containing this
  551.         stuff, along with the HEX address of the start of your
  552.         current environment.
  553.  
  554.  
  555.  
  556.  
  557.  
  558. ==== TEMPORARY PATHS AND POSITIONS ============================================
  559.  
  560.         To create a temporary path, then restore your old path
  561.         later:
  562.  
  563.                 PM /TMP directory
  564.  
  565.         To restore your old path, type: OLD
  566.  
  567.         For example:  PM /TMP c:\utils
  568.                       PM /TMP \wp51
  569.  
  570.         A temporary path would be useful for adding a directory to your
  571.         path that you do not want to be there later.  For example, if
  572.         you want to use Word Perfect, and need to add C:\WP51 to your
  573.         path.
  574.         Once you are done with Word Perfect, it would be a pain to LEAVE
  575.         C:\WP51 in your path, because you're not going to use it anymore.
  576.         Leaving spare directories in your path will slow down DOS'
  577.         performance.  So how are you going to take it out??
  578.  
  579.         Merely create a "temporary path".  To do this, type:
  580.  
  581.                 PM /TMP c:\wp51
  582.  
  583.         This adds c:\wp51 to your current path, and creates a batch
  584.         file called "OLD.BAT" in your directory.
  585.         Now go ahead an run Word Perfect, then type: OLD on the command
  586.         line to restore your original path.
  587.  
  588.         NOTE: OLD.BAT deletes itself   (this is for your convenience)
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.         To insert a directory in your path at a certain position,
  599.         type:   PM  directory  position
  600.  
  601.         So to make C:\UTILS the fourth directory in your path,
  602.         you would type:
  603.                         PM C:\UTILS 4
  604.  
  605.         Directory positions is important because DOS looks through
  606.         each directory in your path one by one for a program.
  607.         So when you type: MENU.EXE, DOS will look through the first
  608.         directory of your path for MENU.EXE, then the second, then the
  609.         third, etc.
  610.  
  611.         If you use MENU.EXE a whole lot, you probably want the directory
  612.         containing it to be the first directory on your path.  Otherwise,
  613.         DOS will search a bunch of needless directories before it
  614.         finally figures out where MENU.EXE is.
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624. ==== WHAT IS A "PATH" ? =======================================================
  625.  
  626.         A path is a list of directories that DOS uses to search
  627.         for files that are not in the current directory.
  628.  
  629.         For example, if I am in the C:\DOS directory, and want to
  630.         use PKZIP.EXE to compress a couple of files, then PKZIP.EXE
  631.         would have to be in the current directory.
  632.  
  633.         BUT, if I have PKZIP.EXE in my C:\UTILS directory, then I
  634.         can just type: PATH=C:\UTILS and dos will look in that
  635.         directory in addition to the current one to find PKZIP.EXE.
  636.  
  637.     NOTE: Data files are not included in the search.  DOS only searches
  638.           for executable files (with extension .EXE or .COM).  If that
  639.           executable file needs a data file somewhere other than the
  640.           current directory, it will NOT FIND IT, because DOS tricks
  641.           the executable file into thinking it is in your current directory.
  642.  
  643.  
  644.    So Why Not Just Include ALL My Directories In My Path ????
  645.  
  646.         Because DOS looks through all the directories in your path
  647.       to find a file, it can eat up your hard disk and take forever
  648.       to run a program.
  649.         Including all your regular utilities into one MAIN directory
  650.       reduces the time DOS takes to find files, and saves your hard
  651.       disk from unnecessary use.
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658. == WHY DO I NEED MORE THAN ONE PATH ??? =======================================
  659.  
  660.         When I compile programs, I need my path to include my Turbo C++
  661.       directory, and my Turbo Assembler directory, and also my Utilities
  662.       dir.
  663.         So when programming, I use:
  664.  
  665.                 PATH=C:\TURBO\BIN;C:\UTILS;C:\DOS;C:\TASM
  666.  
  667.         When I use Turbo Pascal, I need the Toolbox directory, the Turbo
  668.       Pascal directory, and of course my utils:
  669.  
  670.                 PATH=C:\UTILS;C:\DOS;C:\TP\TOOLBOX;C:\TP
  671.  
  672.         But when downloading a file from the local BBS, I need my Procomm
  673.       Plus directory, my B: drive (my SCAN program is there), and my
  674.       downloading directory.
  675.  
  676.                 PATH=C:\DOS;C:\;B:\;D:\PCPLUS;C:\DOWNLOAD
  677.  
  678.         Do you see the conflict ?   Without Path Master, I was using
  679.       12 batch files to do all the work.
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688. ==== WHAT IS THE "ACTIVE" AND "MASTER" ENVIRONMENTS ? =========================
  689.  
  690.         When you first turn on your computer, a line is usually included
  691.         in your CONFIG.SYS that says:
  692.                 SHELL=C:\DOS\COMMAND.COM /P
  693.         or      COMSPEC=C:\DOS\COMMAND.COM
  694.  
  695.         This tells DOS that COMMAND.COM will be used as your command
  696.         processor.  So now, when you type: DIR, the directory command
  697.         is extracted from COMMAND.COM and run.
  698.  
  699.         COMMAND.COM contains a space in itself for the Environment.
  700.         These are variables set by you to determine your preferences.
  701.         The Environment holds things like:
  702.                 ■  Your Path
  703.                 ■  Your Prompt
  704.                 ■  Preferences for other programs (like Norton Backup)
  705.  
  706.         You set these things by typing: SET [variable]=[your preference]
  707.         on the command line.
  708.  
  709.         The MASTER Environment is the COMMAND.COM space that is run when
  710.         you first boot up.  Sometimes in your PC dealings, you may want
  711.         to shell out of a program (like Windows).  When you do this,
  712.         you call COMMAND.COM again, and set up a new Environment.
  713.                 This is the ACTIVE environment.
  714.  
  715.         When you shell out, COMMAND.COM copies its environmental space
  716.         into the new COMMAND.COM space.  However, if you change a setting
  717.         (like your Path), the change is only temporary.
  718.                 Because after you exit back into the program your were
  719.         originally in (Windows), by typing: EXIT, the temporary settings
  720.         are lost, and the old Environmental space is used again.
  721.  
  722.  
  723.         Try this experiment:
  724.  
  725.         1   Type: SET PATH=C:\DOS;C:\MASTERPATH   (be sure to include
  726.                                                    the DOS directory)
  727.             You have changed your path to a new one, that includes
  728.             our key-word MASTERPATH.  This will soon dissapear.
  729.  
  730.  
  731.         2         COMMAND.COM               (this won't work unless you
  732.                                              include the directory that
  733.                                              COMMAND.COM is in on line 1)
  734.             A new environment has been started.  It is a copy of the
  735.             Master environment, but overlaps the Master one.  So that
  736.             any changes made to your new environment are only temporary.
  737.  
  738.  
  739.         3        SET
  740.  
  741.             Note the PATH= statement at the bottom.
  742.  
  743.  
  744.         4        SET PATH=ACTIVE_PATH
  745.  
  746.             We changed the Path to Active_Path.  But this change lasts
  747.             only as long as our new COMMAND.COM is active.
  748.  
  749.  
  750.         5        SET
  751.  
  752.             See our new Path at the bottom?  It is now "ACTIVE_PATH".
  753.  
  754.  
  755.        6         EXIT
  756.  
  757.             We now exited our new COMMAND.COM, and have returned to
  758.             the Master Environment. All the changes to our Active
  759.             Environment have dissapeared.
  760.  
  761.  
  762.        7         SET
  763.  
  764.            See our Path?  It's now back to the original one we
  765.            typed at the beginning.  We have returned to the
  766.            Master Environment.
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774. ====== EXPANDING YOUR PATH ===================================================
  775.  
  776.         You can expand your path in one of the following ways:
  777.  
  778.         1)  Add the line:
  779.                            SHELL=COMMAND.COM /E:# /P
  780.  
  781.             to your CONFIG.SYS file, whereas the # is how many bytes you
  782.             want DOS to use for the environment.  This tells DOS to reserve
  783.             a larger amount of space for your environment.  If you just want
  784.             a large path, 512 or so should be fine.
  785.  
  786.         2)  Start a new copy of COMMAND.COM, telling it your want a bigger
  787.             environment.  Simply type:
  788.                                         COMMAND /E:#
  789.  
  790.             where # is the amount of space you want.
  791.             To return to a normal environment, type: EXIT.  Now you are back
  792.             in your original version of COMMAND.COM.
  793.  
  794.         3)  If you use 4DOS or other command.com replacements, consult your
  795.             manual for directions on EXPANDING YOUR ENVIRONMENT.
  796.  
  797.  
  798.    NOTE:  Use the /BIG or /STACK options for paths longer than 80 characters.
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810. ====== ATTENTION POWER USERS! ================================================
  811.  
  812.         An expanded PATH is a hassle; Keep your path short!  It slows down
  813.         disk performance and causes you to lose precious conventional
  814.         memory when expanding your environment.  Your best bet is to
  815.         consolidate a few directories and have three or four directories
  816.         on each path in PATH MASTER.
  817.  
  818.         If you want a LONG path once in a while, though, use the /BIG
  819.         option, then /WB to write the long path into a batch file.
  820.         Use your normal, shorter paths on a daily basis, but when you
  821.         DO need that extra long path, you can use a quick batch file
  822.         rather than loading PATH MASTER every time.
  823.  
  824.         Also, if you have filled up all 20 configs, use the /DEFAULT
  825.         option.  It'll save your life.
  826.  
  827.         And if you work in an office, or have other people using your
  828.         PATH MASTER, use the /F: option.  I guarantee someone will
  829.         end up editing your \PATH.CFG file, and you'll spend quite
  830.         some time returning it to normal.
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846. ====== COMPARISON TO OTHER UTILITIES ==========================================
  847.  
  848.         Compared to other path utils, Path Master blows them away!
  849. Nothing else loads you up with options like these.  Graphical interface,
  850. advanced information, totally re-configure a path, choose from 20
  851. configurations and so much more.
  852.  
  853.         I looked on 27 BBS' including CompuServe, 14 ShareWare CD Roms
  854. and asked around, and only found 3 utils that come close (I had to
  855. eliminate the ones that just added and deleted directories):
  856.  
  857.         PathTool        New World Designs
  858.         PathUtil        ??
  859.         PathEditor      Ray Dittmeier
  860.         SetPath         Donald E. Ekman
  861.  
  862.         Here is a comparison of features:
  863.  
  864.                            ┌ PATHMASTER
  865.                            │   ┌ PathTool
  866.                            │   │   ┌ PathEditor
  867.                            │   │   │   ┌ SetPath
  868.                            │   │   │   │
  869.        ┌─────────────────┬───┬───┬───┬───┐
  870.        │Graphical menu   │ X │   │   │   │
  871.        ├─────────────────┼───┼───┼───┼───┤
  872.        │Multiple configs │ X │   │   │   │
  873.        ├─────────────────┼───┼───┼───┼───┤
  874.        │Both Active and  │ X │ X │   │ X │
  875.        │Master environ.  │   │   │   │   │
  876.        ├─────────────────┼───┼───┼───┼───┤
  877.        │Mouse support    │ X │   │   │   │
  878.        ├─────────────────┼───┼───┼───┼───┤
  879.        │Add path         │ X │ X │ X │ X │
  880.        ├─────────────────┼───┼───┼───┼───┤
  881.        │Delete path      │ X │ X │ X │ X │
  882.        ├─────────────────┼───┼───┼───┼───┤
  883.        │Add to end/begin │ X │ X │   │ X │
  884.        ├─────────────────┼───┼───┼───┼───┤
  885.        │Sound effects    │ X │   │   │   │
  886.        ├─────────────────┼───┼───┼───┼───┤
  887.        │Modify config.sys│ X │   │   │   │
  888.        ├─────────────────┼───┼───┼───┼───┤
  889.        │Stretch environ  │ X │ X │   │   │
  890.        │if needed        │   │   │   │   │
  891.        ├─────────────────┼───┼───┼───┼───┤
  892.        │Run-time advanced│ X │   │   │   │
  893.        │path info.       │   │   │   │   │
  894.        └─────────────────┴───┴───┴───┴───┘
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903. ===== REGISTRATION ============================================================
  904.  
  905.  
  906.         There are two registration options:
  907.  
  908.         1) $10.00 registers Path Master, gets you the *special* version
  909.            including lots of options not available otherwise.
  910.            This allows unlimited upgrades to Path Master, and free
  911.            technical support by mail or by CompuServe.
  912.  
  913.         2) $20.00 gets you the Dave Utils disk.  See the enclosed
  914.            CATALOG.EXE file for details.  This also gets you the updated
  915.            PathMaster, unlimited upgrades and technical support as
  916.            described above.
  917.            You also get over 30 more utils, and unlimited upgrades on
  918.            those also, new information about other stuff I create, etc.
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929. = EXAMPLES ====================================================================
  930.  
  931.  
  932.  
  933.         PM /E
  934.  
  935.   Edits the current configuration file.
  936.  
  937.  
  938.  
  939.         PM /AE
  940.  
  941.   Pulls up a window and prompts you to add a directory
  942.   to the current path.  It will be added to the END
  943.   of the path.
  944.  
  945.  
  946.  
  947.         PM /TMP  c:\dos
  948.  
  949.  Creates a temporary path with C:\DOS at the end.  To
  950.  restore your original path, just type: OLD.BAT on
  951.  the command line.  OLD.BAT deletes itself.
  952.  
  953.  
  954.  
  955.  
  956.         PM  C:\WP51  2
  957.  
  958.  Makes c:\wp51 the second directory on your path.
  959.  
  960.  
  961.  
  962.  
  963.         PM /AB
  964.  
  965.   Pulls up a window and prompts you to add a directory
  966.   to the current path.  It will be added to the BEGINNING
  967.   of the path.
  968.  
  969.  
  970.  
  971.         PM /DEL
  972.  
  973.   Pulls up a window and prompts you to delete a directory
  974.   in the current path.
  975.  
  976.  
  977.  
  978.         PM C:\DOS;A:\TP\TOOLBOX
  979.  
  980.   Creates a new path that consists of c:\dos and a:\tp\toolbox
  981.   directories.
  982.  
  983.  
  984.  
  985.         PM /?
  986.  
  987.   Shows the help screen.
  988.  
  989.  
  990.  
  991.         PM /S
  992.  
  993.   Displays current path on the screen.
  994.  
  995.  
  996.  
  997.         PM /INFO
  998.  
  999.    Shows fifteen pages of useful information concerning the Path
  1000.    and advanced items that allow you to expand your environment
  1001.    and better understand how your computer works.
  1002.  
  1003.  
  1004.  
  1005.         PM /SIZE
  1006.  
  1007.    Displays a bar graph of how much space you have used in your
  1008.    environment, the hex address of the current environment's
  1009.    beginnings, and other useful stuff.
  1010.  
  1011.  
  1012.  
  1013.         PM /ACT
  1014.  
  1015.    Pulls up the path menu as usual, but adds the selected path
  1016.    to the Active Environment (see above details about Active
  1017.    and Master Environments).
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033. ===== TECHNICAL NOTES =========================================================
  1034.  
  1035.  
  1036.   4DOS: Path Master uses the self-deleting files OLD.BAT and $TMP$.BAT
  1037.         in the current directory.  4DOS seems to have a tantrum when
  1038.         running a self-deleting batch file by saying:
  1039.                 "BATCH FILE MISSING!  C:\OLD.BAT"
  1040.         This is no concern, since the batch file is NOT missing, it
  1041.         merely deleted itself.
  1042.         When writing the path to your environment, if you HAVE any problems
  1043.         using the Master environment, try the active instead.
  1044.                 To accomplish this, use:  PM /ACT
  1045.  
  1046.  
  1047.  
  1048.  
  1049.         Path Master uses a file in your root directory called PATH.CFG,
  1050.         which can be changed using the /F: option.  It also uses PATH.HLP
  1051.         (which must be in the current directory) for any help you may
  1052.         want (by pressing [F1]).
  1053.  
  1054.         Also, be VERY CAREFUL when using the /BIG option.  Once you have
  1055.         a monster path in your environment, you cannot import it into
  1056.         the /Q option.  If so, your path is "cut off" to 80 characters.
  1057.         Realize that your TEXT file in the /BIG option is completely
  1058.         different than the normal config file.  Your /PATH.CFG file is
  1059.         actually a C++ Structure of 20 paths, 80 characters each.
  1060.         Attempting to export a HUGE path into the /SIZE option will
  1061.         result in a mess on the screen.  And adding a directory with
  1062.         the /TMP option to an already PACKED, 150 character path will
  1063.         cut it off short.
  1064.  
  1065.         I also "clean up" your path of repeated semicolons, extra spaces,
  1066.         etc.  So if you type 4 semicolons in a row and wonder where they
  1067.         went....
  1068.  
  1069.         If you include a ':', ';' or '\' after PM, then Path Master
  1070.         automatically assumes you want to set a new path, and will set
  1071.         it to argument one.  This could cause some unexpected results
  1072.         if you're not careful, so please ensure not to stick those
  1073.         after PM.
  1074.  
  1075.         Path Master works by scanning the PSP of COMMAND.COM, locating
  1076.         the environment segment, then altering it.
  1077.         The Active environment is affected by stuffing the keyboard
  1078.         buffer with a batch file that changes the environment.
  1079.  
  1080.         I have tried this technique (with success) on 14 different
  1081.         machines, all of which worked fine.  There may, however,
  1082.         be bugs when running with some systems.
  1083.  
  1084.         If you find a bug, or lock up this program, please report
  1085.         it to me by:
  1086.  
  1087.         COMPUSERVE           71441,2723
  1088.  
  1089.         or by Mail:             David Smith
  1090.                                1104 Mason Dr.
  1091.                                Hurst TX 76053
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101. ======== QUESTIONS AND ANSWERS ===============================================
  1102.  
  1103. General Questions:
  1104.  
  1105.          Q:     All my paths are 120-150 characters long.  Path Master's menu is limited to
  1106.                 80 chars!  How do I use my paths?
  1107.          A:     Use the /BIG option.  Utilize your text editor and create 20 paths up to 150
  1108.                 characters long, then import them by typing:  PM /BIG
  1109.  
  1110.          Q:     Your editor is real limited.  There's no copy/move text functions, and I hate
  1111.                 doing all that typing.
  1112.          A:     Use your favorite text editor, then import your text file containing your paths
  1113.                 using /BIG
  1114.  
  1115.          Q:     I have a great config file with my 20 favorite paths, but I recently made some
  1116.                 new directories and want to add them to my paths.  Do I have to make a new
  1117.                 text file and re-type all that stuff to use /BIG option?
  1118.          A:     If you like the /BIG option, and would rather use that than the usual Path
  1119.                 Master menu, convert your config files using PMCNVRT.EXE.  This makes
  1120.                 the transition from Path Master's usual screen to Path Master's BIG screen.
  1121.  
  1122.          Q:     What's the difference between /PB: and /WB: ?
  1123.          A:     /PB  stands for "Pick and Batch", where you Pick a path from the menu, then
  1124.                 write it to a Batch file.
  1125.                 /WB  stands for "Write a Batch", where you Write the current path to a batch
  1126.                 file.  Later, you can just run the batch file and set your favorite path rather
  1127.                 than running Path Master.
  1128.  
  1129.  
  1130.  
  1131. Questions concerning  /Q
  1132.  
  1133.          Q:     Can I quick edit paths longer than 80 characters?
  1134.          A:     No.  If you use /STACK or /BIG to create a long path, you cannot edit it
  1135.                 with the /Q option.
  1136.  
  1137.          Q:     When I type in characters after first entering the edit screen, it erases my
  1138.                 path.
  1139.          A:     If you have problems with this, press [HOME] before typing characters on the
  1140.                 end of the path.
  1141.  
  1142.  
  1143.  
  1144. Questions concerning  /STACK
  1145.  
  1146.          Q:     If I "stack" two paths on top of each other (both of which are 80 characters
  1147.                 long), DOS cuts off the last few chars.
  1148.          A:     You must expand your environment before "stacking" paths.  DOS limits your
  1149.                 path length to 127 characters, unless you expand it.
  1150.  
  1151.          Q:     How many paths can I stack onto each other?
  1152.          A:     After you have expanded your environment, you can stack up to 499
  1153.                 characters in your path using Path Master.  Just use /STACK over and over
  1154.                 until you reach the maximum length.
  1155.                 NOTE:  If your path is 499 chars long, you have a SERIOUS problem.
  1156.  
  1157.          Q:     What happens if I "stack" too many directories my path?
  1158.          A:     DOS cuts off the path at the point where it runs out of memory.  You'll
  1159.                 notice some characters missing from the end.
  1160.  
  1161.  
  1162.  
  1163.  
  1164. Questions concerning  /BIG
  1165.  
  1166.          Q:     I don't understand.  What's the difference between the usual Path Master
  1167.                 menu and the /BIG menu?
  1168.          A:     The Path Master menu uses a binary config file.  Each path is up to 80
  1169.                 characters long, and your config file holds 20 paths.
  1170.                 The /BIG menu uses a text file.  Each path is up to 150 characters long, and
  1171.                 the text file can hold up to 20 paths.
  1172.          Q:     I have a text file with 27 paths, each 300 characters long.
  1173.                 Can I import them using /BIG?
  1174.          A:     Yes, but only the first 20 lines, and each path will be cut off on the 150th
  1175.                 character.  Path Master stops loading text once it reaches 150 characters, and
  1176.                 cuts off the file when it reads 20 lines.
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.   A GREAT DEAL !
  1190.  
  1191.         See the included CATALOG.EXE to order Dave's Disk full of
  1192.         Utilities.  For only $20.00, it's a definite bargain !
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.    ███████╗ ██╗   ██╗ ██████╗  ██████╗   ██████╗  ██████╗  ████████╗ ██████╗
  1209.    ██╔════╝ ██║   ██║ ██╔══██╗ ██╔══██╗ ██╔═══██╗ ██╔══██╗ ╚══██╔══╝ ╚════██╗
  1210. ╓──███████╗ ██║   ██║ ██████╔╝ ██████╔╝ ██║   ██║ ██████╔╝    ██║      ▄███╔╨─╖
  1211. ║  ╚════██║ ██║   ██║ ██╔═══╝  ██╔═══╝  ██║   ██║ ██╔══██╗    ██║      ▀▀══╝  ║
  1212. ║  ███████║ ╚██████╔╝ ██║      ██║      ╚██████╔╝ ██║  ██║    ██║      ██╗    ║
  1213. ║  ╚══════╝  ╚═════╝  ╚═╝      ╚═╝       ╚═════╝  ╚═╝  ╚═╝    ╚═╝      ╚═╝    ║
  1214. ║                                                                             ║
  1215. ║                                                                             ║
  1216. ║      Support for this program is available in the following ways:           ║
  1217. ║                                                                             ║
  1218. ║                                                                             ║
  1219. ║          ╓──┐ ╓──┐ ╓─╥─┐ ╥──┐ ╥  ┬  ╓─┐ ╥──┐ ╥──┐ ╥  ┬ ╥──┐                 ║
  1220. ║          ║    ║  │ ║ ║ │ ╟──┘ ║  │  ╙─┐ ╟─   ╟─┬┘ ╙╖┌┘ ╟─                   ║
  1221. ║          ╙──┘ ╙──┘ ╨ ╨ ┴ ╨    ╙──┘ ╙──┘ ╨──┘ ╨ ┴   ╙┘  ╨──┘                 ║
  1222. ║          User ID:  71441,2723                                               ║
  1223. ║          I usually log on every other day and check my mail.                ║
  1224. ║                                                                             ║
  1225. ║                                                                             ║
  1226. ║                       ▄▄▄▄▄▄  ▄▄▄▄▄▄  ▄▄▄▄▄▄▄                               ║
  1227. ║                       █ ▄▄ █▄ █ ▄▄ █▄ █ ▄▄▄▄█                               ║
  1228. ║                       █ ▄▄▄ █ █ ▄▄▄ █ █▄▄▄▄ █                               ║
  1229. ║                       █▄▄▄▄▄█ █▄▄▄▄▄█ █▄▄▄▄▄█                               ║
  1230. ║          Drop me a line on the MotherBoard II Bulletin Board                ║
  1231. ║                     David Smith   (214) 642-1287                            ║
  1232. ║                                                                             ║
  1233. ║                                                                             ║
  1234. ║                 ▄██▄   ▄██▄  ▄███████▄   ▄█▄  ▄██▄                          ║
  1235. ║                 █████▄█████ ████▀▀▀████ █████ ████                          ║
  1236. ║                 ███████████ ████▄▄▄████ █████ ████                          ║
  1237. ║                 ████   ████ ███████████ █████ ████                          ║
  1238. ║                 ████   ████ ████   ████ █████ ████▄▄▄▄▄▄▄                   ║
  1239. ║                 ▀██▀   ▀██▀ ▀██▀   ▀██▀  ▀█▀   ▀████████▀                   ║
  1240. ║                               Write to:                                     ║
  1241. ║                                                                             ║
  1242. ║                              David Smith                                    ║
  1243. ║                            1104 Mason Dr.                                   ║
  1244. ║                            Hurst TX 76053                                   ║
  1245. ║                                                                             ║
  1246. ╙─────────────────────────────────────────────────────────────────────────────╜
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.