home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 91 / af091a.adf / af91a1.lzx / SUBmods / WBarg / ReadMe < prev    next >
Encoding:
Text File  |  1996-09-15  |  1.5 KB  |  42 lines
  1.  
  2. Greetings ACE programmer!
  3.  
  4. This is my first attempt at producing a non-toy ACE subprogram library module.
  5.  
  6. The essential files are: WBarg.o and WBarg.h. Notice that WBarg.h here is NOT the same
  7. as ACEinclude:WBarg.h! Its basic purpose is to provide external declarations to the
  8. subprograms in WBarg.o. The latter is an object module that must be linked with a 
  9. program wishing to use any of the subprograms externally declared in WBarg.h. Use the
  10. simple "Make" shell script, eg. make test, for this purpose.
  11.  
  12. WBarg.o contains subprograms to handle Workbench arguments (as documented in ace.doc) 
  13. and tooltypes (not provided before). There is also a function which returns true or
  14. false depending upon whether the program was Workbench-launched.
  15.  
  16. The file WBarg.b contains the source code to WBarg.o.
  17.  
  18. The test files consist of:
  19.  
  20.     test        '..the executable (type: "Make" to get this file). 
  21.     test.b
  22.     test.info
  23.     arg1.info
  24.     arg2.info
  25.     arg3.info
  26.  
  27. To see what the program does, create a temporary drawer from the Workbench, copy
  28. these files into it and experiment. See the comments at the top of test.b for more.
  29.  
  30. After playing with the program, go take a look at the source files: WBarg.b, WBarg.h,
  31. test.b (probably in the reverse of that order).
  32.  
  33. I'll admit that creating subprogram library modules is not as straightforward as
  34. it should be right now. I'm working on it though. At least _using_ them is fairly
  35. easy given the appropriate ".h" file.
  36.  
  37. All comments are welcome.
  38.  
  39. Regards,
  40.  
  41. David Benn, 5th March 1994
  42.