home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 623a.lha / fd2inline / README < prev    next >
Text File  |  1992-03-24  |  2KB  |  65 lines
  1.  
  2.               Hi There
  3.  
  4. This is a little utility to convert fd-files and prototypes to inline
  5. functions for gcc in order to directly call any exec library from within your
  6. GNU-C programs. This is a 0.9 version in order to let you see what's coming.
  7.  
  8.  
  9.     bin/auto
  10.  
  11. This is a (g)awk script, which extracts protos from autodocs (gee, are they
  12. ugly). This script is called by bin/auto2proto. It is VERY tolerant, but the
  13. autodocs are even more tolerant... They contain many misformed headers. Most
  14. errors will be listed and functions which might be functions you actually
  15. wanted will be appended with the word 'maybe'. So look through the output !!!
  16.  
  17.     bin/auto2proto
  18.  
  19. This SKsh script calls awk with auto and scans through all autodocs for
  20. function prototypes. Output is put into proto/ and errorlogs are put into
  21. error/.
  22.  
  23.     inline.mk
  24.  
  25. This Makefile controls the making of proto/* and inline/* and calls auto2proto
  26. and fd2inline. It is generated by bin/mandeps, which is called by Makefile.
  27.  
  28.     Makefile
  29.  
  30. The global makefile contains stuff for configuring and starting the other
  31. programs. Just read it and adapt it for your own installation.
  32.  
  33.     fd2inline
  34.  
  35. This is a GNU-C Program, which parses fd-files and proto includes, and outputs
  36. inline calls for GNU-C. I started this as an exercise for object oriented
  37. thinking and was surprized by my productivity... It should give meaningful
  38. errormessages ( meaning that there's an error in the input and not in the
  39. program... ;-) ). You should expect errors like that it can't find some
  40. functions or the number of arguments don't fit... that's because CBM people
  41. don't know what good documentation is good for... yes, documentation, well,
  42. this IS a 0.9 version, it will improve. Please don't use any source yet, the
  43. 1.0 will be absolutely free and under the GNU Licence. Use this version for
  44. bugreports, should there be any...
  45.  
  46.     BUGS
  47.  
  48. Well, not really a bug, but something you should not copy: When ^C is hit, the
  49. program does not do any cleanup with atexit(). This does not hurt at the
  50. moment, but it *IS* dirty. This will be fixed for 1.0.
  51.  
  52.  
  53.     P.S.
  54.  
  55. I just ripped the needed files together, invented a Makefile and put it into
  56. an archive. If something is missing or your Hardisk is low-level formatted,
  57. that's completely tough luck, as I don't imply any usability.... (I hate legal
  58. stuff). Please try it out and send reports to
  59.  
  60.     s_baron@ira.uka.de
  61.  
  62. Enjoy,
  63.  
  64.                             Wolfgang
  65.