home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 3 / goldfish_volume_3.bin / files / text / edit / ttx_m2s / ttx_m2s.docs < prev    next >
Encoding:
Text File  |  1995-04-09  |  5.0 KB  |  114 lines
  1. /* TurboText ARexx Macros for M2Sprint Modula-2 */
  2. /* Version 1.0, 4 April 95 by J. E. Gilpin */
  3. /*
  4. $VER: TTX_M2S 1.0 (04.04.95)
  5. */
  6.  
  7. This archive should contain the following files:
  8.  
  9. M2S_Compile.ttx-------TurboText AREXX Macro for Compiling.
  10. M2S_Link.ttx----------TurboText AREXX Macro for Linking.
  11. M2S_ErrList.ttx-------TurboText AREXX Macro for error tracing.
  12. M2S_CompSettings.ttx--TurboText AREXX Macro for setting compiler parameters.
  13. M2S_LinkSettings.ttx--TurboText AREXX Macro for setting linker parameters.
  14. TTX_Startup.dfn-------TurboText startup definition file.
  15. TTX_Startup.prf-------TurboText startup preferences file.
  16. TTX_Startup.ttx-------TurboText startup AREXX Macro.
  17. TTX.info--------------TurboText project icon (with required tool types set).
  18. ScreenFlags-----------Public Screens Utility by Chris Papademetrious.
  19.  
  20.  
  21. INTRODUCTION:
  22.  
  23.    If you use the "M2Sprint" (Copyright 1989 M2S Inc.) Modula-2 compiler,
  24. you've probably noticed that the M2Sprint text editor, unlike the compiler
  25. and linker, isn't quite compatable with newer versions of the Amiga
  26. operating system. Last year I decided to find a replacement for my M2Sprint
  27. editor. My search for a new editor ended when I discovered that the author
  28. of the M2Sprint editor (Martin Taillefer) is also the author of "TurboText"
  29. (Copyright 1990-1994 Martin Taillefer).
  30.    I purchased "TurboText" and found it to be very similar in design and
  31. function to the M2Sprint editor. The latest version of TurboText
  32. (TurboText 2.0) is 'Amiga User Interface Style' compliant and has an
  33. extensive AREXX command set. With addition of a few AREXX Macros, TurboText
  34. can fulfill almost any text editing requirement.
  35.    Despite an extensive search of public domain sources, I was unable to
  36. find the AREXX scripts necessary to create a completely integrated
  37. Modula-2 programming environment. As a result, I created my own scripts and
  38. have included them in this archive. Since it is unlikely that many people
  39. use both TurboText and M2Sprint, I have excessively commented the scripts
  40. for use as examples (possibly bad examples). Hopefully, someone else may
  41. find them of some use.
  42.  
  43.  
  44. SYSTEM REQUIREMENTS:
  45.  
  46.    1. Amiga computer with AmigaDOS 2.0 or higher.
  47.    2. Hard Disk Drive
  48.    3. TurboText 2.0
  49.    4. M2Sprint Modula-2 program developement system.
  50.  
  51.  
  52. INSTALLATION:
  53.  
  54.    1. Create an empty directory anywhere on a hard disk drive.
  55.    2. Copy all the files in this archive to the newly created directory.
  56.    3. Open the new directory on the WorkBench screen and select the
  57.       TurboText Project Icon.
  58.    4. Select the "Information" sub-menu from the "Icons" menu on the
  59.       WorkBench Screen.
  60.    5. Make the following changes in the "Information" window:
  61.       a. Edit the name in the "Default Tool" gadget to match the pathname
  62.          of the TTX program (TurboText startup program) on your system.
  63.       b. Edit the paths in the "Tool Types" gadget to match the directory
  64.          path where these scripts are located (the newly created directory).
  65.       c. Select the SAVE gadget in the "Information" window.
  66.    6. Load the file "TTX_Startup.ttx" (from the newly created directory) and
  67.       make the following changes:
  68.       a. Edit the assignments for "M2:", "M2Data:" & "M2Sprint:" to match
  69.          the location (path) of those directories on your system.
  70.       b. Edit the assignment for "Turbo:" to match the location of the
  71.          scripts included with this archive (the newly created directory).
  72.       c. Save the edited file.
  73.  
  74.  
  75. USAGE:
  76.  
  77.    1. Copy a Modula-2 source program to RAM:
  78.  
  79.    2. Open the editor using the project icon provided in this archive.
  80.  
  81.    3. Load the Modula-2 program into the editor.
  82.  
  83.    4. Press the F6 function key to compile the program.
  84.  
  85.    5. Press the F7 function key to link the program.
  86.  
  87.    6. Press the F8 function key to step through any errors indicated in
  88.       the compilation (step 4).
  89.  
  90.    7. Press the F9 function key to change compiler settings.
  91.  
  92.    8. Press the F10 function key to change linker settings.
  93.  
  94.  
  95. OPERATION:
  96.  
  97.    Since TurboText 2.0 is designed to edit multiple documents on differently
  98. defined Screens and Windows simultaneously, these Macros can be employed
  99. without altering your current TurboText settings. The included definition
  100. file (TTX_Startup.dfn) is the default TurboText definition with the F6-F10
  101. function keys redefined to call the Macros included in this archive.
  102. The Macro assigned to each of those function keys will be loaded from disk
  103. and executed each time the function key is pressed. The Macros don't open
  104. any AREXX communication ports, they simply execute programs (compiler,
  105. linker, settings etc.). That results in a lot of disk activity, but makes
  106. the Macros more generalized and modifiable.
  107.    Because the Compiler and Linker settings programs were designed to open a
  108. window on the WorkBench Screen, the public screen utility "ScreenFlags" is
  109. used to fool them into opening on the TurboText screen. If more than one
  110. TurboText screen is open, the settings programs may open on the wrong
  111. screen.
  112.    Read the comments in the Macros for more information.
  113.  
  114.