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.dok < prev    next >
Encoding:
Text File  |  1991-12-31  |  3.9 KB  |  86 lines
  1. ======================================================================
  2.  Dokumentation zum Modul Menu2Asm  04-Jun-91  Jürgen Zimmermann
  3.  Autor: Jürgen Zimmermann, Ringstr. 6, W-6719 Altleiningen, Deutschland
  4. ======================================================================
  5.  
  6. Kopierrecht
  7. ===========
  9. Das komplette Packet (Quelltext, Dokumentation und Objektcode) ist
  10. Freeware. Es darf beliebig kopiert und verbreitet werden
  11. solange...
  12.  
  13. * mein Name und dieser Kopierrechtshinweis erhalten bleiben,
  14. * die Vollständigkeit des ganzen Packets gewährleistet ist, und
  15. * mit dem Vertrieb dieser Software kein Gewinn erwirtschaftet wird.
  16.  
  17. Verbesserungsvorschläge sind stets willkommen. Falls Ihr Veränderungen
  18. am Programm vornehmt, dokumentiert diese bitte gut verständlich.
  19. Es würde mich freuen, wenn Ihr mich über größere Veränderungen in
  20. Kenntnis setzen würden. Weiterhin bitte ich Euch, mir einen ausführlichen
  21. Bug-Report zu schreiben, wenn irgenein Fehler auftreten sollte, damit ich
  22. mich an die Verbesserung des Moduls machen kann.
  23.  
  24.  
  25. Umfang des Packets
  26. ==================
  27. Das komplette Packet "Menu2Asm" beinhaltet folgendes:
  28.  
  29. *  Menu2Asm.dok   Diese Dokumentation
  30. *  Menu2Asm.mod   Der Quelltexte des Moduls
  31. *  Menu2Asm.def   Die Definition des Moduls
  32. *  -.obj + -.sym  Die Objekt- bzw. Symboldatei des Moduls
  33.  
  34.  
  35. Zu "Menu2Asm"
  36. ====================
  37. Das Modul "Menu2Asm" ermöglicht es, mit dem neuen Modula-2-Compiler
  38. M2Amiga V4.0d fertig initialisierte Menüs zu erstellen, die dann in das
  39. Endprogramm gelinkt werden, ohne daß man noch zusätzlichen Quelltext für
  40. den Aufbau des Menüs benötigt.
  41.  
  42. Die Erstellung eines Menüs ist denkbar einfach: Nachdem man im eigenen
  43. Programm ein Menü erzeugt hat und dieses mittels IntuitionL.SetMenuStrip an
  44. ein Window installiert hat, ruft man die Prozedur Menu2Asm.MakeMenu2Asm(Zeiger
  45. auf das Window) auf. Danach erscheint auf dem Workbench-Screen ein
  46. neues Window (bei Workbenchstart des eigenen Programms) oder im CLI/SHELL eine
  47. Titelzeile, in der der Name incl. Pfad der Zieldateien erfragt wird. Eine an den
  48. Filenamen angehängte Erweiterung (z.B. ".hallo") wird vom Programm ignoriert.
  49. Das Modul schreibt nun sowohl ein Definitions- als auch ein Implementations-
  50. modul in das gewünschte Verzeichnis. Weiterhin wird noch eine Datei mit dem
  51. Namen "PrgName"+"Asm.asm" erzeugt, die den A68k-kompatiblen Quelltext für das
  52. Menü in Assembler enthält. Der Quelltext muß mit einem anderen Assembler als
  53. dem des M2Amiga assembliert werden, da dieser z.Zt. keine veränderbaren Daten
  54. unterstützt. Alles, was man jetzt noch machen muß, ist das Compilieren der
  55. -.def bzw. -.mod-Datei sowie das Assemblieren der -.asm-Datei. Zu beachten
  56. ist, daß die Objektdatei nach dem Assemblieren den gleichen Namen hat wie
  57. die -.asm-Datei, jedoch mit der Erweiterung ".obj" versehen ist und sich vor
  58. dem Linken im Verzeichnis "obj/" befindet, sofern ein solches angelegt ist,
  59. damit der Linker sie findet.
  60.  
  61. Das Menü wird jetzt einfach so benutzt, indem man den Zeiger auf das Menü aus
  62. dem Modul importiert und direkt an "IntuitionL.SetMenuStrip" übergibt.
  63. Die zeit- und speicheraufwendige Initialsierung der Menüstruktur kann man
  64. nun aus dem eigenen Programm verbannen (aber bitte nicht löschen, für zukünftige
  65. Änderungen). Das Menü in Assembler sollte nur am Ende einer Programmierphase
  66. stehen, da das Ändern im Modula-2-Quelltext sehr viel bequemer ist (besonders
  67. mit Hilfe von m2make!).
  68.  
  69.  
  70. Für diejenigen unter Euch, die keine Mühe scheuen:
  71. Man kann sich die beiden von Menu2Asm erzeugten Modula-2-Module auch schenken,
  72. indem man einfach die Variablenzeile aus dem Definitionsmodul in das eigene
  73. Modul integriert (auf keinen Fall die Zeile ändern!) und die beiden Module
  74. löscht (spart den Code für das leere Implementationsmodul, ca. 80 Bytes).
  75. Dies entspricht meiner eigentlichen Absicht, aber für Eilige habe ich die
  76. andere Funktion integriert!
  77.  
  78.  
  79.  
  80. Viel Spaß noch bei eigenen Menüs
  81.  
  82.  
  83.    Euer
  84.  
  85.       Jürgen
  86.