home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / useful / util / edit / mg / readme.mg3beta4 < prev    next >
Text File  |  1990-06-02  |  3KB  |  55 lines

  1. This is a beta release of mg3. The major changes are an internal
  2. reorganization (hence the version number change), the addition of
  3. named macros, and the addition of an ARexx port to the Amiga version.
  4. The changes for the final release version are not as yet all in place.
  5. However, it will be at least a year before those changes are in a
  6. version as stable as the current beta. Since the ARexx changes are
  7. major for the Amiga, but the user-visible changes for other systems
  8. are relatively minor, this is an Amiga-only release.
  9.  
  10. It is a beta. It has not been as thoroughly tested as a normal
  11. release, and there are outstanding unverified bug reports. However, it
  12. has been in active use for 5-10 person years, and is relatively solid
  13. as a beta. You should have no troubles if you use it in patterns
  14. similar to the people who have been using it in prior beta tests.
  15. Unusual useage will probably cause problems.
  16.  
  17. Warning: this version of mg tends to eat a lot of stack. stack 20000
  18. is recommended.
  19.  
  20. To fit everyghing on one disk, the sources have been put into lharc. To
  21. put things back, create a toplevel directory, and do
  22.  
  23.     lharc -a -x x sources.lzh
  24.  
  25. in that directory.
  26.  
  27. The Rexx routines provided have been contributed by various people
  28. using the beta releases. Some of them haven't been tested, so examine
  29. them carefully before use.
  30.  
  31. The programs in tools are used in the Makefiles. They are probably
  32. dependent on the environment they are built in - for instance, many
  33. expect the C startup code to do glob expansion. They are provided
  34. mostly to aid in convincing the Makefile's to work correctly; it's
  35. expected that those interested enough to want to recompile the sources
  36. will have their own versions of most of these commands. In particular,
  37. the ARP or AmigaDOS 2.0 equivalents shouldn't suffer from the
  38. limitation of the AmigaDOS 1.X versions that caused these to be
  39. written.
  40.  
  41. To build a version from scratch, read through the docs on config, and
  42. create a config file for the version you would like to build. Run the
  43. rexx script config to create the directory where the version you are
  44. going to build will reside, then issue either a "make" or an "lmk"
  45. command, depending on which you are using.
  46.  
  47. If you don't have ARexx (you should get a copy, but that can wait),
  48. the directory BURRITO provide a full-featured configuration for
  49. Lattice 5.0x. Edit the .h files to match what config would do to them
  50. (the information required for this is in the config documentation),
  51. then do a "lmk -f /amiga/lmkfile depend" (for Lattice) or "make -f
  52. /amgia/Makefile.### depend", where #### is MANX for Manx 3.6, and
  53. AZTEC for AZTEC 5.0.  This will construct the appropriate Makefile for
  54. that directory.
  55.