home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Programming / Basic / MAXONB32.DMS / in.adf / docs.lha / FD_TO_BMAP < prev    next >
Encoding:
Text File  |  1994-10-31  |  1.7 KB  |  59 lines
  1.  
  2.  
  3.              FD to BMAP converter
  4.  
  5.  
  6.  
  7. Function Description files are the standard
  8. method of detailing function calls, procedures
  9. and parameter passing for an Amiga¨ library,
  10. device or resource. They are supplied by
  11. Commodore for the operating system and by
  12. software houses for third-party extension
  13. libraries.
  14. Historically AmigaBASIC used a different format
  15. of file, the .bmap file which contains similar
  16. information to that in the .fd file but in a
  17. binary rather than ASCII format.
  18. To allow you to call Amiga¨ libraries other
  19. than the operating system ones directly
  20. supported by MaxonBASIC, we include a ´FD to
  21. BMAP´ conversion utility. What this does is to
  22. generate a .bmap file which allows you to call
  23. all of the library functions. In order to use
  24. it you must first obtain an FD file for the
  25. relevant library, e.g. midi_lib.fd.
  26. Note that this conversion does not generate any
  27. DECLARE statements for the routines in the
  28. library since this information does not exist
  29. within the FD file.
  30. As with the Operating System, your program must
  31. first open the library using LIBRARY OPEN.
  32.  
  33.  
  34. Usage
  35.  
  36. FDtoBMAP can either be run from the command
  37. line or from the Workbench. If it is run from
  38. the Workbench then you will be prompted to
  39. enter the full name of the .fd file being read
  40. and the .bmap file being created.
  41. The command line syntax accepted by FDToBMAP is
  42. simply:
  43.  
  44.  FDToBmap <input_lib.fd> [<output.bmap>]
  45. By default, the generated BMAP file has the
  46. same name as the FD file (with the _lib.fd
  47. extension removed and .bmap added) although you
  48. may wish to over-ride this with the optional
  49. output name parameter.
  50. For example, to convert the req.library FD file
  51. you might use:
  52.  
  53.  FDToBmap req_lib.fd
  54. or, if you wish to add directory
  55. specifications:
  56.  
  57.  FDToBmap DF0:fd/req_lib.fd  bmap:req.bmap
  58.  
  59.