home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_progs / prog_oth / menu2asm.lzh / Menu2Asm / Menu2Asm.doc < prev    next >
Encoding:
Text File  |  1991-12-31  |  3.2 KB  |  80 lines
  1. ==========================================================================
  2.  Documentation for the modul Menu2Asm  04-Jun-91  Jürgen Zimmermann
  3.  Author: Jürgen Zimmermann, Ringstr. 6, W-6719 Altleiningen, Germany
  4. ==========================================================================
  5.  
  6. Copyright
  7. ===========
  9. The whole package (source, documentation and objectcode) is
  10. freeware. It is allowed to copy and spread it as long as...
  11.  
  12. * my name and the copyright-note are left in,
  13. * the completeness of the package is guaranteed,
  14. * no profit is made by copying, selling or using my programs.
  15.  
  16. Suggestions are always welcome. If you do any modifications with the
  17. program, please document them. If there are many or great changes of
  18. the source by you, you should send me a note about them. If you find
  19. any bugs in the program, please send me a detailed bug-report, I'll
  20. work on it.
  21.  
  22. The package "Menu2Asm"
  23. =====================
  24. The whole package "Menu2Asm" contains:
  25.  
  26. *  Menu2Asm.doc   This documentation
  27. *  Menu2Asm.dok   The german documentation
  28. *  Menu2Asm.mod   The source of the modul
  29. *  Menu2Asm.def   The source of the definition
  30. *  -.obj + -.sym  The object-  symbol-files of the modul
  31.  
  32.  
  33. To "Menu2Asm"
  34. =============
  35. With the modul "Menu2Asm" it is possible to use initialized
  36. menus with the new version of the Modula-2-Compiler M2Amiga V4.0.
  37. The menus are linked together with the program, no additional
  38. source-code is neccessary to built up the structures at run-time.
  39.  
  40. The way to use "Menu2Asm" is as easy as possible: after you have built up
  41. YOUR menu an installed it with the procedure IntuitionL.SetMenuStrip to
  42. a window, call the procedure Menu2Asm.MakeMenu2Asm(pointer to your
  43. window). At this time a window opens on the Workbench Screen (if you
  44. started your program from the workbench) or a message in the CLI/SHELL
  45. appears. Now you must type in the whole name and path you want the produced
  46. source to be written to. Any extension (e.g. ".hallo") of the filename is
  47. ignored!
  48. The procedure then writes a definition- and an implementation-modul.
  49. Also a file named "programname"+"Asm.asm" is produced, which contains
  50. the A68k-compatible source for the menu-structure. All you have to do now is
  51. to assemble the assembler-source with an assembler and to compile the
  52. definition- and implementation-modul with M2Amiga. The assembled file
  53. MUST have the extension ".obj" and MUST be put in the "obj/"-directory of
  54. the project - if you have one. The objectfile MUST also have the same name
  55. as the source, because the linker looks for it with that name!
  56.  
  57. To use the menu in your own program, you just import the pointer to the
  58. menu (called "MenuStrip") and install the menu using the function
  59. "IntuitionL.SetMenuStrip". There now is no need for the time- and
  60. space-wasting initialization of the menu during program-start,
  61. it is already there!
  62.  
  63.  
  64. And now a hint to all professional programmers:
  65. The two by "Menu2Asm" produced Modula-2-modules are only for the quick and
  66. easy use of pre-initialized menus. If you copy the "VAR"-line of the
  67. definition-module in your own source, you no longer have the need for
  68. the the definition- and the implementation-module. You also have a gain
  69. of about 80 bytes space!
  70.  
  71.  
  72.  
  73. Bye,
  74.  
  75.  
  76.     Yours
  77.  
  78.  
  79.       Jürgen
  80.