home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / UTILS1 / GO311.ZIP / GO.DOC < prev    next >
Text File  |  1994-01-16  |  8KB  |  167 lines
  1.          
  2. --------------------    GGGGGGGG        OOOOOOO       !!!
  3. ------------------    GG      GG      OO     OO      !!!
  4. -----------------    GG              OO     OO      !!!
  5. ----------------    GG    GGGG      OO     OO      !!!
  6. ---------------    GG      GG      OO     OO        
  7. ---------------    GGGGGGGG        OOOOOOO       !!!
  8.  
  9.  
  10.          "The way that CHDIR should have been written."
  11.  
  12. ---------------------------------------------------------------------------
  13. GO!     Version 3.11  -  January 15, 1993  -   Written by Steven M. Ryckman
  14. ---------------------------------------------------------------------------
  15.  
  16. GO! is a utility with a very simple purpose in life, to take a command
  17. line argument and search the directory tree for a directory which matches
  18. or contains the command line argument.  It does this by searching all
  19. valid hard drives in the range of C - Z after searching the current drive.
  20. For example if the current drive is E: and you use the command line of
  21. GO WORK, it will search drives in the order ECDFGH...Z until it finds
  22. a directory with WORK in the name or runs out of directories to search.
  23. If GO! finds a qualifying directory, it changes to that drive and directory.
  24.  
  25. The shareware version of GO! only searches two levels deep.  What this
  26. means is that if you ran the command GO WORK, it would find the directory
  27. called C:\WORKDIR or C:\XXX\WORKDIR but not C:\XXX\YYY\WORKDIR.
  28. The registered version of GO! searches up to ten layers deep.
  29.  
  30. When GO! finds a directory matching the command line argument you specify
  31. it looks for a file with the same name as the filename portion of that
  32. directory.  Ie: If the directory has a 'dot' extension, only the first
  33. part of the name is used. Ie: Directory LOTUS.123 would look for LOTUS.BAT
  34. If that file is found, it is executed upon ending automatically.
  35.  
  36. If any errors occured during GO!'s execution, upon terminating it will
  37. set the Dos ERRORLEVEL to 1.  This includes not finding the directory
  38. specified, keystroke termination or anything else that prevented GO!
  39. from finding a directory match.  If you will be using GO! from a .BAT
  40. file and are familiar with the Dos ERRORLEVEL function, this should be
  41. sufficient information for you.  If GO! completes normally, then the
  42. ERRORLEVEL will remain at 0 (normal).
  43.  
  44. GO! normally searches for sub-directories which include the search text that
  45. you specify on the command line.   GO WORK   would find either D:\WORKS
  46. or D:\DOCSWORK (whichever it finds first).  By placing a slash at the start
  47. of the search text, GO will only find directories starting with the text.
  48. Thus   GO \WORK  would find D:\WORKS  but not D:\DOCSWORK.  Likewise,
  49. GO WORK\ would only find a directory ending with WORK and would not locate
  50. the D:\WORKS directory in the previous example since the trailing S would
  51. un-qualify that directory.  Exact name matches can be searched for by
  52. specifying the starting and ending slash.  Ie: GO \A\ would only find
  53. an exact match of a directory called A and none that contained A in it.
  54.  
  55. GO! will either search all drives on your system or a specified list
  56. of drives you provide.  By default, GO! searches drives C through Z in
  57. order.  You can limit the drives that GO! searches by one of two ways.
  58.  
  59. GO! will check for an environment variable named GO and use any letters
  60. it finds there as the search sequence.  For instance, SET GO=DCAB 
  61. would cause to search the hard drives backwards.  D first, then C and
  62. also search the floppies (if any) are in the drive.  (GO! does not
  63. search floppies unless you tell it to)
  64.  
  65. GO! will also look for drive letters on the command line.  Place the
  66. drives to search as the first characters on the command line followed
  67. by a colon and the seach sequence.  Ie: GO DCAB:APPLE would cause GO!
  68. to search drives D,C,A & B for the directory APPLE.
  69.  
  70. GO! searches the directories in 'LEVEL' order and not in a tree
  71. structure.  For example, if your drive has the directories:
  72.  
  73. C:\DOS
  74. C:\DOS\UTIL
  75. C:\DOS\PCKWIK
  76. C:\WORD
  77.  
  78. GO! will search through the directories in layer 1 (C:\DOS and
  79. C:\WORD) then through layer 2 (C:\DOS\UTIL and C:\DOS\PCKWIK).
  80.  
  81. If you happen to make a typo and GO! is searching every drive and
  82. directory for your wrong name, press a key and at the next "safe
  83. opportunity" GO! will terminate it's search.
  84.  
  85. GO! has some command line options as well, they follow the search
  86. string and are all preceeded by a slash.
  87.  
  88.     /?     =  Display short help screen.
  89.  
  90.     /NOA   =  No abort by keystroke allowed.
  91.  
  92.     /NOD   =  Don't display anything but search twirl.
  93.             (only in registered copies).
  94.     
  95.     /NOX   =  Don't auto-execute .BAT file if found.
  96.  
  97.     /PAU   =  Pause for keystroke before exiting.
  98.  
  99. GO! is now "Desqview aware" meaning that it will automatically detect
  100. if it is running in a DV window and if it is, will give up time
  101. slices while it's doing internal processing.  This is important
  102. especially for machines running BBS or other communications intensive
  103. applications in another DV window as timing is critical.  Previously,
  104. GO! would "hog" the processor until it was done.  If GO! detects it's
  105. running under Desqview, it will put [DV] at the end of the second line
  106. of it's display for your information only.  
  107.  
  108. GO! is not fancy.  I wrote it because I could not find a utility which
  109. would allow me to change directories in a complex multi-layer directory
  110. structure easily.  Now if I want to go to the directory on my H: drive
  111. which stores my Word documents, instead of doing the two commands  H:
  112. and then CD \WINDOWS\WORD\WORDDOC, I can just type GO DOC and it will
  113. take me there much faster and easier.
  114.  
  115. GO! is shareware and may be shared, distributed, etcetera as long as
  116. you receive no renumeration for it in any form (postage, handling fees
  117. and the like are included in this), and GO! is not modified in any way.
  118.  
  119. You are granted use of GO! for thirty days free of charge.  After thirty
  120. days, if you don't think GO! is worth the small $ 5.00 registration charge
  121. then erase it off your machine.
  122.  
  123. If you have registered a previous version of GO! and still know your
  124. registration information, you can register this version of GO! to you
  125. easily using the REGME.EXE provided.  Read the file REGME.DOC for 
  126. more details.
  127.  
  128. GO! was written using Microsoft's Professional Development System (P.D.S.)
  129. version 7.1 with many other home-brewn libraries and functions.  It has been
  130. tested on several 386 and 486 machines and should work on basically any
  131. system - but I can't guarantee it.  You use GO! at your own risk.
  132. The only requirements I can tell you for sure are that GO! needs between
  133. 280kb and 508kb to run, depending on how many drives and directories
  134. are on your machine to search.
  135.  
  136. Two forms of registration are available:
  137.  
  138. "Post-card" registration is only $5.00 and includes your serial number
  139. and update code mailed back to you.  You then use the REGME.EXE included
  140. with this version of GO! to register the program yourself.
  141.  
  142. "Disk" registration is $10.00 and includes the post card as well, but 
  143. also includes a copy of the most recent version of GO! on disk.
  144.  
  145. Either forms of registration entitle you to all future versions of GO!
  146. at no additional charge.  Just hang onto your postcard with your serial
  147. number and update code and when you see a new version of GO! on your
  148. favorite BBS, download it and register it to you with the REGME.EXE
  149. provided with that version of GO!.
  150.  
  151. Print the file REGISTER.FRM for an official registration form.
  152.  
  153. GO! is a very simple program and as such you should not have any problems
  154. in using it.  I encourage suggestions for improvements to GO! so please
  155. feel free to contact me by one of the methods below should you need to
  156. contact me.
  157.  
  158.     I can be reached, by mail:  GO! registration
  159.                 c/o Steve Ryckman
  160.                 38703 Sheridan Road  #203
  161.                 Beach Park, IL 60099-3981
  162.  
  163.   At my local BBS, by calling:  708-872-8086  (1200/9600 8n1 24hrs)
  164.  
  165. Or from any RIME network node:  Site ->229 in the COMMON or the
  166.                 ALARM/SECURITY conferences.
  167.