home *** CD-ROM | disk | FTP | other *** search
/ Aminet 10 / aminetcdnumber101996.iso / Aminet / dev / gui / mui31mod.lha / MUI / Developer / Modula / ReadMe < prev   
Encoding:
Text File  |  1995-11-27  |  6.3 KB  |  153 lines
  1. Modula-Interface for MUI 3.1, Version 3.1.1 (27.11.95)
  2.  
  3. MUI (C) 1993-95 by Stefan Stuntz
  4.  
  5. Modula Interface update v2.2 done by Christian "Kochtopf" Scholz (freeware)
  6. Modula Interface for v3.1 done by Olaf "Olf" Peters (still freeware :-)
  7.  
  8. ---------------------------------------------------------------------------
  9. ----- Olf's Notes for Interfaces v3+ --------------------------------------
  10. ---------------------------------------------------------------------------
  11.  
  12. Revision history:
  13.  
  14. v3.1.1 (27.11.95, olf)
  15.  
  16. - MuiD.def now really has the MUIOBSOLETE compiler option. This was missing
  17.   in the MUI 3.1 release.
  18.  
  19. - due to Stuntzi's automatic headerfile generation, MUI2COMPAT will not be
  20.   supported any longer.
  21.  
  22. - Demos now compile with MUIOBSOLETE set to FALSE, which also means they
  23.   will only run with MUI 3 (and above). Be careful, they do *not* check,
  24.   which MUI version you're using!
  25.  
  26. +++++
  27.  
  28. While updating the Modula interfaces to MUI-3 I have made some minor
  29. changes to MUIClasses (to make them more "Modula-like"), so don't wonder,
  30. if your programs do not compiled out of the box with the new interface.
  31. However my changes should not affect too many programs, so I hope you can
  32. live with them.
  33.  
  34. Also there is a compiler-option in the modules which may need some
  35. explanation:
  36.  
  37.   MUIOBSOLETE
  38.  
  39. set this to TRUE to enable all the tags that have been declared obsolete
  40. during MUI-development. *Please* try to update your programs so they
  41. compile with MUIOBSOLETE set to FALSE.
  42.  
  43. The interfaces are not too heavily tested, but I'm currently developing a
  44. bigger application with them (which also uses custom-classes). At least I
  45. didn't discover any bugs until now (Nov 27, 1995) :-)
  46.  
  47. Anyway, if you discover any bugs or missing tags, please contact Christian
  48. or me, to ensure they are included in the next release of the Interfaces.
  49.  
  50. My address is:
  51.  
  52. Olaf Peters
  53. Kulmer Str. 7
  54. 28237 Bremen
  55.  
  56. eMail preferred: olf@informatik.uni-bremen.de
  57.  
  58. Have fun!
  59.  
  60.   Olf
  61.  
  62. ---------------------------------------------------------------------------
  63. ----- Kochtopf's Notes for Inferfaces up to v2.2 --------------------------
  64. ---------------------------------------------------------------------------
  65.  
  66.  
  67. Here are the files you need to write MUI-Programs with M2Amiga.
  68. Present are in this version the macros defined in mui.h. They are
  69. implemented in MuiMacros and in MuiClasses (the ones related to
  70. custom-class-programming)
  71.  
  72.  
  73. Description of the files :
  74.  
  75.     MuiD.def        : Definitions of MethodIDs, AttributeIDs, etc.
  76.     MuiD.mod        : Some additional PROCEDUREs for some #define's in mui.h
  77.     MuiL.def        : The interface for muimaster.library
  78.     MuiSupport.def  : Additional PROCEDUREs like DoMethod or fail.
  79.     MuiSupport.mod  : The implementation of these PROCEDUREs.
  80.     MuiMacros.def   : Some Macros converted from mui.h
  81.     MuiMacros.mod   : The implementation of these.
  82.     MuiClasses.def  : some things you need to write own classes
  83.     MuiClasses.mod  : implementation of the macros defined in mui.h for classes
  84.     MuiTest.mod     : A sample Module showing how to use the interface.
  85.     ListDemo.mod    : A sample Listview programm showing an DisplayHook!
  86.     Class1.mod      : A sample Module showing how to write own classes in M2.
  87.  
  88.     In this version you have to compile the interface yourself.
  89.     For this can you use the CompilerScript. It will compile the
  90.     interface and copy the files to m2:modules/sym|obj.
  91.  
  92.  
  93. The History :
  94.  
  95. 22.10.1993 MuiSupport : changed fail-PROCEDURE, that it makes no use of
  96.                         Terminal, but now uses Arts.Requester.
  97.            MuiMacros  : Added macros AddMember, DelMember, MakeHook,
  98.                         MakeID, PopUp
  99. 26.10.1993 supplied CompilerScript
  100. 9.2.1994   MuiD       : Updates to 1.5 (Popasl, Popstring, PopObject... )
  101.                         added mPaletteEntry, mScrmodelist.
  102.            MuiL       : Updates to 1.5 (Custom Class Functions)
  103.                         changed return-value of mAslRequest to BOOLEAN 
  104.                                                 (thanx to Thilo Stoeferle)
  105.                         provided muiMasterVersion, etc. like System-Defs.
  106.            MuiSupport : fail will set app to NIL, now VAR-parameter 
  107.                         (so you can use it in a CLOSE-Routine)
  108.                                                 (thanx to Martin Koyro)
  109.            MuiMacros  : now it supports StrPtr instead of ARRAY OF CHAR.
  110.                         set the symbol Locale to TRUE to get it. (defaults to FALSE)
  111.                         added some macros by Martin Koyro (KeyRadio, (Key)Cycle, (Key)Slider)
  112.            MuiClasses : new Module which implements things to write own classes.
  113.            ComboBox   : removed - use PopObject for a Popup-List.
  114.            ListDemo   : New Demo to show how to do lists.
  115. 18.2.1994  MuiMacros  : Added functions for Register and the Pop*-Classes.
  116.                         Added some new Label-Macros (LLabel,... )
  117.            MUIClasses : Added some macro-definitions and rearranged a bit the
  118.                         module. Now you can do easily custom classes with it.
  119.                         (i hope :) So look at it for more info and look also
  120.                         at Class1.mod which shows how it is used.
  121.            Class1.mod : new demo which shows how to do custom classes.
  122. 25.6.1994  MuiD,      
  123.            MuiMacros,
  124.            MuiL       : upgraded to version 2.1
  125.                         added a new symbol MUIObsolete to MuiMacros. Set it to true,
  126.                         if you want the obsolete Macros, now you should use mMakeObj
  127.                         for them.
  128.                         Problems with MakeObject-Definition - does not work.
  129.                         I don't know why - you ? ;-) Please tell me!
  130.                         (so you should set MuiObsolete to TRUE ;-)
  131.  
  132.            MuiClasses : changed name from MUIClasses to MuiClasses - please note!!
  133. 11.7.1994  MuiL.def   : changed MakeObject to use the right registers. Now works!!
  134.  
  135.  
  136. Note :
  137.  
  138. This time I just wanted to say that this stuff is _completely_ untested because of lack
  139. of time. I am just happy that it compiles ;-)
  140. I think that I have the next days some free hours to play with the new MUI (perhaps
  141. writing a class :-)
  142. Perhaps I will then release a new version on aminet...
  143.  
  144. For bug-reports or suggestion please send me a note. Thanks.
  145.  
  146. My email-address :
  147.  
  148.     ruebe@pool.informatik.rwth-aachen.de
  149.  
  150.  
  151. Greets,
  152.      Kochtopf
  153.