home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / UTILITY / MISC / GO.ZIP / GO.PRN < prev   
Encoding:
Text File  |  1990-06-24  |  6.3 KB  |  169 lines
  1.  
  2.         Tom Jennings
  3.         World Power Systems/Fido Software
  4.         Box 77731
  5.         San Francisco
  6.         CA 94107
  7.  
  8.         June 90
  9.  
  10.  
  11.         ----------------
  12.         HOW TO USE:
  13.  
  14.                 GO              Harmlessly lists some basic information 
  15.                                 to remind you how it all works, and to 
  16.                                 plug the author (me).
  17.                 GO ?            Displays the list of available 
  18.                                 directories.
  19.                 GO =            Re-enters the last-entered 
  20.                                 drive/subdirectory.
  21.  
  22.                 GO name         Log into the named drive. 
  23.  
  24.         ----------------
  25.         REQUIRED:
  26.  
  27.                 GO.EXE          the program, what else
  28.                 GO.MAP          sample map file (see text)
  29.                 GO.DOC          guess what
  30.                 GO=<map path>   DOS environment variable "GO", so GO.EXE
  31.                                 can find the text file.
  32.  
  33.         ----------------
  34.         WHAT IT DOES:
  35.  
  36.         Lets you name your hard disk subdirectories and "GO" to that
  37.         name, instead of long, cumbersome, error-prone CHDIR pathnames
  38.         and drive letter changes.
  39.  
  40.         It also has one cute feature that remembers the last drive/subdir
  41.         you were on, so that when you boot up later, it logs you back in
  42.         there. (Optional of course.)
  43.  
  44.         ----------------
  45.         WHY:
  46.  
  47.         I don't know about you, but I have two hard disks (C: and D:),
  48.         and a zillion subdirectories on each. Mine are arranged by
  49.         project; about half have another level of subdirectories, and
  50.         some of those have even more.
  51.  
  52.         Traversing them is a pain in the neck. When changing from one to
  53.         the other, I have to remember which drive I'm on, change drives,
  54.         then CD or CHDIR to the right subdir, getting all the \'s and
  55.         suchlike correct. 
  56.  
  57.         Not only that, if you have more than one hard disk, you can
  58.         invoke that unpleasant, obscure DOS side effect of the "logged in
  59.         subdir" on another drive; ie. when you're currently on D:, and
  60.  
  61.         you say "CHDIR C:\FOO\BAR", then later you do a "DIR C:"
  62.         (thinking you'll get the list of files in the drive's root
  63.         directory) you get the contents of C:\FOO\BAR instead. Yuck.
  64.  
  65.         ----------------
  66.         HOW TO INSTALL:
  67.  
  68.         First, set the environment variable "GO", which GO.EXE uses to
  69.         locate the file that contains all these. For example ...
  70.  
  71.                 SET GO=C:\BIN\GO.MAP
  72.  
  73.         SET command in your AUTOEXEC.BAT file, so it's set upon bootup.
  74.         GO.EXE will complain if it can't find the things it wants.
  75.  
  76.         Next -- the text file itself (example here: GO.MAP) contains the
  77.         list of names (that you enter as your destinations) and full path
  78.         specifiers (that GO.EXE actually goes to). They are arranged one
  79.         per text line, with space(s) between them. For example, here's
  80.         part of my GO.MAP file:
  81.  
  82.         =c:\lastdir
  83.         \   \
  84.         c:   c:\
  85.         mslib   c:\mslib
  86.         mylib   c:\mylib
  87.         fidotools   c:\fido\tools
  88.         bin   c:\bin
  89.         dos   c:\dos
  90.         files   c:\fidosw\files
  91.         d:   d:\
  92.         book   d:\fidobook
  93.         pctex   d:\pctex
  94.         texinputs   d:\pctex\texinputs
  95.         homocore   d:\homocore
  96.         shipley   d:\texts\shipley
  97.  
  98.         This is a "standard" (sic) MSDOS/CPM text file -- ASCII
  99.         characters, each line terminated with CR/LF (13/10 decimal). 
  100.         End-Of-File Control-Z not needed but tolerated.
  101.  
  102.         Blank lines and lines beginning with semicolons (;) are ignored.
  103.         Lots of blank lines and/or comments will slow the program down.
  104.  
  105.         GO is simple to use -- if you enter "GO FILES", Go will (1) open
  106.         the file named in the "GO" environment variable, (2) search for
  107.         the line containing "FILES" as the first word and (3) change to
  108.         the subdirectory (second word), using these two rules:
  109.  
  110.                 (a) If the new, target subdirectory is on the current, 
  111.                     default drive, GO simply CHDIRs to the subdir. (ie.
  112.                     if you're in C:\FOO\BAR, it would simply do "CHDIR
  113.                     \FIDOSW\FILES")
  114.  
  115.                 (b) If the new, target directory is on a drive other
  116.                     than the current, default drive, GO does first a
  117.                     "CHDIR \" to log into the root of the current drive,
  118.                     then changes drives, then CHDIRs to the subdir. (ie.
  119.  
  120.                     if you're in D:\SUBDIR\BABBLE, it would do "CHDIR \"
  121.                     to log into the root, drive change D: to C:, then 
  122.                     "CHDIR \FIDOSW\FILES".)
  123.  
  124.  
  125.         You can manually change drives and/or subdirectories whenever you
  126.         want to. You will not confuse GO.EXE.
  127.  
  128.         ----------------
  129.         DOS ERRORLEVELS:
  130.  
  131.         GO.EXE returns ERRORLEVEL 0 when things go right, and 1 when
  132.         things go wrong.
  133.  
  134.  
  135.         ----------------
  136.         WHAT ABOUT THAT FUNNY EQUAL SIGN (=)
  137.  
  138.         If you were observant, you noticed that the first line in my
  139.         sample GO.MAP file is different than the rest. The presence of
  140.         this line enables a fancy, optional feature: "remember the last
  141.         drive/directory".
  142.  
  143.         The pathname after the "=" is the name of a disk file where GO
  144.         will store the last-GO'd to subdir. The example here is a good
  145.         one -- the root of the boot disk, though anywhere will do. The
  146.         last-dir file is tiny, simply the name of the last logged
  147.         directory. If you last entered "GO FILES", C:\LASTDIR would
  148.         contain "FILES". (Note not the pathname "C:\FIDOSW\FILES".) It is
  149.         a one-line text file. 
  150.  
  151.         OK, so GO remembers the last GO'd to directory. How to use it?
  152.  
  153.                 GO =
  154.  
  155.         When given "=" as a subdir name, it will use the contents of the
  156.         =<pathname> from the GO.MAP file, and "GO" there. 
  157.  
  158.         ----------------
  159.         AND SO:
  160.  
  161.         If you use GO.EXE to do most or all of your directory changes (I
  162.         do!), if you have ...
  163.  
  164.                 GO =
  165.  
  166.         you turned your machine off.
  167.  
  168.         -- end
  169.