home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 6 File / 06-File.zip / go320.zip / GO.DOC < prev    next >
Text File  |  1994-11-07  |  11KB  |  204 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.20  -   November 7, 1994  -   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. Two versions of GO! are included in this zip file, GO.EXE will run on
  31. any IBM 8086 or greater type machine.  GO386.EXE is optimized for
  32. and will only run on IBM 80386 or greater type machines.  The 386
  33. optimization allows the compiler to make a slightly smaller as well
  34. as slightly faster program.  If you are running on a 386 or better
  35. type machine, you can delete GO.EXE and rename GO386.EXE to GO.EXE.
  36.  
  37. GO! checks it's own integrity now and will report if someone or thing
  38. has modified the program.  The default for the un-registered version
  39. is "Full" checking.  You can disable this checking all-together with
  40. the /NOS option (No Self-Checking).  This will allow the program to
  41. start about 1 second faster but will not warn you if a virus or
  42. other program modifies GO!.  Registered users have the ability of
  43. setting the integrity check to a "Partial" mode which still performs
  44. some basic integrity checks and should catch most virus' that attach
  45. themselves to executable programs, but is not as secure as the full
  46. check.  Partial mode is only slightly slower than no integrity check.
  47.  
  48. GO! will automatically use up to ten (10) dos file buffers internally
  49. when searching your hard drive(s) if they are available.  Many programs
  50. place a BUFFERS = 1 command in your CONFIG.SYS file.  There are many
  51. things to factor into any change to this line, but I will tell you that
  52. GO! will run quadruple, if not faster with a BUFFERS = 10 instead of
  53. a BUFFERS = 1 statement in your CONFIG.SYS.
  54.  
  55. When GO! finds a directory matching the command line argument you specify
  56. it looks for a file with the same name as the filename portion of that
  57. directory.  Ie: If the directory has a 'dot' extension, only the first
  58. part of the name is used. Ie: Directory LOTUS.123 would look for LOTUS.BAT
  59. If that file is found, it is executed upon ending automatically.
  60.  
  61. If any errors occured during GO!'s execution, upon terminating it will
  62. set the Dos ERRORLEVEL to 1.  This includes not finding the directory
  63. specified, keystroke termination or anything else that prevented GO!
  64. from finding a directory match.  If you will be using GO! from a .BAT
  65. file and are familiar with the Dos ERRORLEVEL function, this should be
  66. sufficient information for you.  If GO! completes normally, then the
  67. ERRORLEVEL will remain at 0 (normal).
  68.  
  69. GO! normally searches for sub-directories which include the search text that
  70. you specify on the command line.   GO WORK   would find either D:\WORKS
  71. or D:\DOCSWORK (whichever it finds first).  By placing a slash at the start
  72. of the search text, GO will only find directories starting with the text.
  73. Thus   GO \WORK  would find D:\WORKS  but not D:\DOCSWORK.  Likewise,
  74. GO WORK\ would only find a directory ending with WORK and would not locate
  75. the D:\WORKS directory in the previous example since the trailing S would
  76. un-qualify that directory.  Exact name matches can be searched for by
  77. specifying the starting and ending slash.  Ie: GO \A\ would only find
  78. an exact match of a directory called A and none that contained A in it.
  79.  
  80. GO! will either search all drives on your system or a specified list
  81. of drives you provide.  By default, GO! searches drives C through Z in
  82. order.  You can limit the drives that GO! searches by one of two ways.
  83.  
  84. GO! will check for an environment variable named GO and use any letters
  85. it finds there as the search sequence.  For instance, SET GO=DCAB 
  86. would cause to search the hard drives backwards.  D first, then C and
  87. also search the floppies (if any) are in the drive.  (GO! does not
  88. search floppies unless you tell it to)
  89.  
  90. GO! will also look for drive letters on the command line.  Place the
  91. drives to search as the first characters on the command line followed
  92. by a colon and the seach sequence.  Ie: GO DCAB:APPLE would cause GO!
  93. to search drives D,C,A & B for the directory APPLE.
  94.  
  95. GO! also checks for an environment variable named GOOPT which can
  96. contain default options for GO! on your system.  For instance if
  97. you never want GO! to automatically execute a .BAT file that it
  98. may find, put SET GOOPT=/NOA in your autoexec.bat file.
  99.  
  100. GO! searches the directories in 'LEVEL' order and not in a tree
  101. structure.  For example, if your drive has the directories:
  102.  
  103. C:\DOS
  104. C:\DOS\UTIL
  105. C:\DOS\PCKWIK
  106. C:\WORD
  107.  
  108. GO! will search through the directories in layer 1 (C:\DOS and
  109. C:\WORD) then through layer 2 (C:\DOS\UTIL and C:\DOS\PCKWIK).
  110.  
  111. If you happen to make a typo and GO! is searching every drive and
  112. directory for your wrong name, press a key and at the next "safe
  113. opportunity" GO! will terminate it's search.
  114.  
  115. GO! has some command line options as well, they follow the search
  116. string and are all preceeded by a slash.
  117.  
  118.     /?     =  Display short help screen.
  119.  
  120.     /NOA   =  No abort by keystroke allowed.
  121.  
  122.     /NOD   =  Don't display anything but search twirl.
  123.             (only in registered copies).
  124.  
  125.     /NOS   =  No virus/self-check is performed.
  126.     
  127.     /NOX   =  Don't auto-execute .BAT file if found.
  128.  
  129.     /PAU   =  Pause for keystroke before exiting.
  130.  
  131. GO! is now "Desqview aware" meaning that it will automatically detect
  132. if it is running in a DV window and if it is, will give up time
  133. slices while it's doing internal processing.  This is important
  134. especially for machines running BBS or other communications intensive
  135. applications in another DV window as timing is critical.  Previously,
  136. GO! would "hog" the processor until it was done.  If GO! detects it's
  137. running under Desqview, it will put [DV] at the end of the first line
  138. of it's display for your information only.  
  139.  
  140. GO! also will use the Desqview video segment for the current window.
  141. Previously, GO! wrote directly to the video cards' memory in all
  142. circumstances.  This could cause GO's display to "bleed through" into 
  143. other Desqview windows and force it to always use it's own colors.
  144. Now GO! will, upon detecting Desqview, ask Desqview for it's video
  145. segment to write to instead of the video cards actual address.  This 
  146. should cause GO! to co-operate nicely with Desqview even when the
  147. "virtualization" is not turned on for a desqview window.
  148.  
  149. GO! is not fancy.  I wrote it because I could not find a utility which
  150. would allow me to change directories in a complex multi-layer directory
  151. structure easily.  Now if I want to go to the directory on my H: drive
  152. which stores my Word documents, instead of doing the two commands  H:
  153. and then CD \WINDOWS\WORD\WORDDOC, I can just type GO DOC and it will
  154. take me there much faster and easier.
  155.  
  156. GO! is shareware and may be shared, distributed, etcetera as long as
  157. you receive no renumeration for it in any form (postage, handling fees
  158. and the like are included in this), and GO! is not modified in any way.
  159. The only exceptions are listed in the DISTRIB.DOC file included.
  160.  
  161. You are granted use of GO! for thirty days free of charge.  After thirty
  162. days, if you don't think GO! is worth the small $5 - $10 registration fee
  163. then erase it off your machine.
  164.  
  165. If you have registered a previous version of GO! and still know your
  166. registration information, you can register this version of GO! to you
  167. easily using the REGME.EXE provided.  Read the file REGME.DOC for 
  168. more details.
  169.  
  170. GO! was written originally using Microsoft's QuickBasic version 4.0.  We
  171. later then moved up to the Microsoft Professional Development System
  172. version 7.1 with many other home-brewn libraries and functions.  It has 
  173. since then been re-written using PowerBasic 3.00c compiler.  GO! has been
  174. tested on several 386 and 486 machines and should work on basically any
  175. system - but I can't guarantee it.  You use GO! at your own risk.
  176. The only requirements I can tell you for sure are that GO! needs between
  177. 200kb and 508kb to run, depending on how many drives and directories
  178. are on your machine to search.
  179.  
  180. Two forms of registration are available:
  181.  
  182. "Post-card" registration is only $5.00 and includes your serial number
  183. and update code mailed back to you.  You then use the REGME.EXE included
  184. with this version of GO! to register the program yourself.
  185.  
  186. "Disk" registration is $10.00 and includes the post card as well, but 
  187. also includes a copy of the most recent version of GO! on disk.
  188.  
  189. Either forms of registration entitle you to all future versions of GO!
  190. at no additional charge.  Just hang onto your postcard with your serial
  191. number and update code and when you see a new version of GO! on your
  192. favorite BBS, download it and register it to you with the REGME.EXE
  193. provided with that version of GO!.
  194.  
  195. Print the file REGISTER.FRM for an official registration form.
  196.  
  197. GO! is a very simple program and as such you should not have any problems
  198. in using it.  I encourage suggestions for improvements to GO! so please
  199. feel free to contact me by one of the methods listed in the file named
  200. AUTHOR.DAT in this archive.
  201.  
  202. If you are interested in distributing GO! as part of a CD Rom, Disk of
  203. the month, Shareware catalog or the like.... read the file DISTRIB.DOC.
  204.