home *** CD-ROM | disk | FTP | other *** search
/ Borland Programmer's Resource / Borland_Programmers_Resource_CD_1995.iso / utils / catch / readme.doc < prev    next >
Encoding:
Text File  |  1995-05-19  |  6.0 KB  |  186 lines
  1. Catch Version 1.00
  2. Written by Sean Batten 1992
  3.  
  4. Catch is a batch programming language for Windows. It is easy to use whilst
  5. being powerful in execution. It allows you to automate many of the mundane
  6. tasks involved in working in the Windows environment.
  7.  
  8. Catch is also, by its nature, upgradeable. It provides you with the ability
  9. to use functions provided by third party suppliers as if they were standard
  10. Catch functions, thus eliminating the need to wait for Catch updates.
  11.  
  12. There are 2 main file which make up Catch. They are:
  13.  
  14.                 CATCH.EXE
  15.                 HELPBOX.EXE
  16.  
  17. CATCH.EXE is the batch file interpreter.
  18. HELPBOX.EXE if the help file which contains a list
  19.             of instructions for Catch.
  20.  
  21. There is also a series of .WBF files which provide examples of some of the
  22. features of Catch.
  23.  
  24. This file has eight sections:
  25.  
  26.     1. Installing Catch
  27.     2. Running a .WBF file
  28.     3. Changing a .WBF file's icon
  29.     4. Creating you own .WBF file
  30.     5. Creating your own Catch libraries
  31.     6. Comments
  32.     7. Thanks
  33.         8. Registering
  34.  
  35. Installing Catch
  36. ================
  37.  
  38. To install Catch creata a directory on your disk, for example, C:\CATCH
  39. and copy the file CATCH.EXE, HELPBOX.EXE and the .WBF example files into
  40. this directory. 
  41.  
  42. From Windows create a new program group and add Catch and Helpbox to the
  43. groups.
  44.  
  45. Next double click on Catch and a dialog box will appear. 
  46. Select 'Set up Catch'. Another dialog box will appear. Select
  47. 'Set up Catch' and the necessary changes will be made to your WIN.INI file
  48. so that you can execute a .WBF by just double clicking on it.
  49.  
  50.  
  51. Running a .WBF file
  52. ===================
  53.  
  54. Once Catch is set up you are ready to run .WBF files. You can run a .WBF by
  55. double clicking on its icon in Program Manager or by double clicking on its
  56. name in File Manager.
  57.  
  58. To begin with we'll run a .WBF file from the File Manager. Load up the File
  59. Manager and move to the directory into which you copied Catch.
  60.  
  61. There will appear a list on .WBF files. Double click on NOTEPAD.WBF This
  62. file allows you to run Notepad in a variety of ways and will give you
  63. a feel of some of the tasks you can carry out with Catch.
  64.  
  65.  
  66. To run a .WBF file from Program Manager you must first add it to a program
  67. group. Move to the Catch group and then select File and New from the Program
  68. Manager menu bar. Click on Program Item and then OK. Move to the box which
  69. says Command Line and enter the fully qualified filename of the .WBF file. 
  70. For example, if you wanted to add NOTEPAD.WBF and it is in a directory 
  71. called C:\CATCH you would type C:\CATCH\NOTEPAD.WBF as the command line.
  72.  
  73. Next click on OK and the .WBF file will be added to the program group.
  74.  
  75.  
  76. Changing a .WBF file's icon
  77. ===========================
  78.  
  79. If you grow board with the icon which Program Manager assigns to your
  80. .WBF file you can easily change it. Catch comes with 5 pre-defined icon
  81. which you can select. To change a .WBF file's icon do the following:
  82.  
  83. 1. Click once on the .WBF icon.
  84.  
  85. 2. Select File followed by Properties from the Program Manager menu.
  86.  
  87. 3. Click on Change Icon.
  88.  
  89. 4. Change the filename to the fully qualified filename of Catch.
  90.    For example, if Catch in in a directory called C:\CATCH set filename
  91.    to C:\CATCH\CATCH.EXE
  92.  
  93. 5. Click on View Next until the icon you want appears.
  94.  
  95. 6. Click OK.
  96.  
  97. 7. Click OK.
  98.  
  99. The icon is now changed.
  100.  
  101.  
  102. Creating you own .WBF file
  103. ==========================
  104.  
  105. To create your own .WBF file simply load up any suitable text editor and
  106. type in the instructions.
  107.  
  108. When you save the file it MUST have the extension .WBF .Catch does not
  109. recognise any files without this extension.
  110.  
  111.  
  112. Creating your own Catch libraries
  113. =================================
  114.  
  115. As you may have already discovered, Catch allows you to write your own
  116. functions which can be accessed using the UseLib function. For example,
  117. if you have a library called CATCH.DLL which contains a function called
  118. Lower which converts a string to lower case and a function called StrLen
  119. which returns a string containing the number of characters in a string, then
  120. you can access these functions in the following way:
  121.  
  122. UseLib ("catch.dll")
  123. Let name=Lower("FRED")
  124. Let len=StrLen(name)
  125.  
  126. Catch deals with the responsibility of accessing the functions in the .DLL
  127. along with the parameter passing and error checking at the end of the
  128. function.
  129.  
  130. As you can see, the benefits of being able to use seperate Catch libraries
  131. are many. You are no longer tied to waiting for the next version of Catch in 
  132. order to get any extra functions that you may need. Third party vendors
  133. will be able to develop their own libraries and pass them on.
  134.  
  135. In order to develop a Catch library you will need a good knowledge of C and
  136. Windows programming. Catch requires certain functions to be present in you
  137. .DLL in order to determine the number of parameters a functions takes, and
  138. also to determine if an error has occured.
  139.  
  140. If you wish to develop Catch libraries then e-mail me at :
  141.  
  142.         cs_e404@kingston.ac.uk
  143.  
  144.  
  145. Comments
  146. ========
  147.  
  148. If you have any comments on Catch, or any requests for functions you would
  149. like to see in the next version of Catch then please write to me at the
  150. following address:
  151.  
  152.     Sean Batten
  153.     112 Grand Avenue
  154.     Berrylands
  155.     Kingston Upon Thames
  156.         England
  157.         KT5 9JA
  158.  
  159. or email me on cs_e404@kingston.ac.uk
  160.  
  161. Thanks
  162. ======
  163.  
  164. Thanks to the following people who helped make Catch possible:
  165.  
  166.     Melissa, for putting up with me all the time I was sat at the
  167.     computer!
  168.  
  169.     Sharon, for making the worlds worst cup of tea!!
  170.  
  171.     Borland, for Turbo C++ for Windows.
  172.  
  173. And greetings to:
  174.  
  175.         Nick, James, Pete, the 2 Rachels, Simon and Raymond Chan,
  176.         and all those I know.
  177.  
  178. Registering
  179. ===========
  180.  
  181. If you plan to use Catch on a regular basis then fine. However, as I'm
  182. an impoverished student it would be jolly descent of you to make the
  183. effort to register Catch. For information on how to do so see the file
  184. REGISTER.DOC which is supplied with Catch
  185.  
  186.