home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / dosutils / go100.arj / GO.DOC < prev   
Encoding:
Text File  |  1991-07-30  |  3.8 KB  |  91 lines
  1.                                   GO.COM
  2.  
  3.  
  4. GO is a quick utility proggie I wrote in response to an unwieldy batch-
  5. program facility used by a chap I know in a software department somewhere
  6. in darkest Hampshire.  The program itself is used to go quickly between
  7. sub-directories on (multiple) hard disks by means of typing
  8.  
  9.                              GO [mnemonic]
  10.  
  11. instead of eg.
  12.  
  13.                              D:
  14.                              CD\MSC\BIN\CTASK
  15.  
  16. or somesuch.
  17.  
  18. The mnemonic would normally be derived from the last sub-directory name
  19. (in the example above 'CTASK'), any number of mnemonics may be stored
  20. in a file called GO.DAT, and that placed in either a directory defined by
  21. the environment variable GO  (eg. SET GO=C:\ in your autoexec.bat file)
  22. or anywhere in the DOS PATH.  This file may be hidden if you wish.  (I hate
  23. clutter!)
  24.  
  25. Below is the header for the parsing function extracted from the source
  26. which describes the format for the GO.DAT file ...
  27.  
  28.  
  29. /****************************************************************
  30. * Reads the data file that holds the information about the      *
  31. * directory locations, looking for a match on the string passed *
  32. * in.  The format for the input file is ...                     *
  33. *                                                               *
  34. *  abbreviation   drive    pathname\n                           *
  35. *                                                               *
  36. *  where:                                                       *
  37. *       abbreviation = abbreviation for the full path name      *
  38. *              drive = destination drive designator             *
  39. *           pathname = DOS pathname desired                     *
  40. *                                                               *
  41. *   Example:                                                    *
  42. *                                                               *
  43. *      bin  d  \msc\bin -> d:\msc\bin                           *
  44. *                                                               *
  45. *****************************************************************/
  46.  
  47. For non-'C' programmers, '\n' means 'Hit the Return key'
  48.  
  49. On completion, the DOS ERRORLEVEL is set.  Non-zero returns indicate
  50. an error.  The relevant numbers are ...
  51.  
  52. 0 = All OK
  53. 1 = Command line invalid
  54. 2 = Mnemonic not found in the GO.DAT file
  55. 3 = Drive/Directory specified not found
  56. 4 = Unable to find the GO.DAT file
  57.  
  58.  
  59. I am releasing this program as shareware - not because I think I can/should
  60. make any money from it, but because it is a _principle_ which ought to be
  61. encouraged.  (Some of the best software I have seen is shareware).
  62. I would ask only £4.00 for the private use of the utility, £15.00 for
  63. corporate use and an extra £4.00 for the source code if desired.  (I would
  64. be interested to see if I actually get anything!).
  65.  
  66. The source was written under Microsoft 'C' v6.0, but will compile under
  67. just about any make/version you care to name with litle (probably no)
  68. effort.  (Turbo 'C' users should need only to change the name of one
  69. #include file for instance).  The whole source file is just over 250 lines
  70. long, with mucho comments.  I got the impetus to write this having seen a
  71. similar proggie in a book whilst browsing - I unfortunately forget not
  72. only the name of the American author, but the book title as well.
  73. From memory though, this version is marginally better anyway.
  74.  
  75. The whole program is supplied 'as is', without guarantees of any kind, but
  76. I will gladly respond to bug reports etc. and (reasonable) requests from
  77. registered users for enhancements and modifications.
  78.  
  79. Please send all queries, comments, undocumented design features (bugs),
  80. money etc. to me at ...
  81.  
  82. Charles O'Flynn
  83. 1 Kipling Road
  84. EASTLEIGH
  85. Hants.
  86. SO5 4EJ
  87.  
  88. Tel. 0703-644097   (Eves. & W/Es)
  89.  
  90. Cix Mail may be addressed to 'pri'
  91.