Other Functionality - mgtrans-22.e and doc_ezr.eng

mgtrans.zip contains two files, mgtrans-22.e and doc_ezr.eng, not mentioned anywhere else.

mgtrans-xx.e is a Lugaru Epsilon extension (.e = epsilon extension language) that I wrote so I could (1) create .ezr files from individual program exports, and, (2) when viewing an .ezr file, set up the Epsilon status line with the task name of the insertion point and enable code coloring to enhance readability.

The part of mgtrans-xx.e which I currently use is the status line and code-coloring portion. I don't use that part which converts a single program too often any more because the mgtrans perl script, while only working on the whole application (at least in its current state of testing), gives much more detailed information and I know it works dependably for 8.2.

doc_ezr.eng exists to properly condition the Magic Document Export for use by the .ezr creation function in mgtrans-xx.e.

doc_ezr.eng was originally written for 5.xx, but has some mods to be compatible with 8.2. I haven't looked at this in some time and currently don't have any plans to support it.

Incorporating the mgtrans-xx.e macro into Epsilon

  • Read this file into Epsilon (load it like any other ordinary file)
  • Run the command 'compile-buffer' or tap the equivalent Alt-F3.
  • Run the command 'write-state', leaving the supplied path, and then press ENTER, so that the compiled buffer is made part of your epsilon.sta file and will be automatically available next time epsilon loads.

    Using the macro

  • Use doc_ezr.eng to export a Magic program as a document output file.
  • Load the export file into the Epsilon text editor.
  • Translation begins at the cursor, so to translate the whole file, make sure cursor is at the beginning of file.
  • Run the command translate-magic-doc.
  • View the translated output in the buffer `wMagicEzRead.

    Best Way to View the Created Files

    Once you have incorporated mgtrans-xx.e into Lugaru's Epsilon the .ezr files will become even more readable.

    The '.ezr' extension enables code coloring and the current task's name to display.
    Sample screenshot showing task's name in buffer's status line
    Sample screenshot demonstrating code coloring


    Last Updated: Nov 25 2000    
    ira@gershenhorn.com      Copyright  © 1998,1999,2000 Ira L. Gershenhorn. All rights reserved.