home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Texteditors / Textra116 / Docs / SASC.ReadMe < prev    next >
Encoding:
Text File  |  1996-09-27  |  4.1 KB  |  107 lines
  1.  
  2. (Editor's note: I placed the rest of Jim's files in 'scripts/SASC_Scripts'.)
  3. (               Also, the Installer will prompt about installing these.    )
  4.  
  5.  
  6. Using Textra with SAS/C
  7. -----------------------
  8.  
  9. by James Cooper, SAS Institute, Inc.
  10.  
  11.  
  12. Textra is extremely easy to use with the SAS/C compiler, in place of the
  13. SAS Editor (named SE).
  14.  
  15. Copy the supplied SCMSG file to ENV:sc. Then skip to Step 2 below.
  16. (Ed-note: You'll want to edit the SCMSG file and set the
  17. EDITCOMMAND line to point to your Textra.  Look at the file.
  18. You'll find SCMSG in the 'scripts/SASC_Scripts' dir AND
  19. appended to the end of this ReadMe file).
  20.  
  21. If you can't find this file, or need to regenerate it (or just want to do
  22. it yourself "by hand"), do the actions specified in Step 1:
  23.  
  24. 1) Run the SCMSG program from a CLI or Shell.
  25.  
  26.         a) When the SCMSG window opens, use the right mouse button to
  27.            access the "Project/Set Options" menu item.  Several items in
  28.            the options window that need to be changed:
  29.            (in all options below, do not include the double-quote marks
  30.            when entering data into the string gadgets)
  31.  
  32.                 i)   PortName - edit this string gadget to contain
  33.                      "TEXTRA".
  34.  
  35.                 ii)  EditCommand - edit this string gadget to contain
  36.                      "Textra %f".  If you don't normally have a path to
  37.                      the Textra executable, you will need to supply the
  38.                      complete path, as in "Work:Editors/Textra/Textra %f".
  39.  
  40.                 iii) GotoFile - edit this string gadget to contain
  41.                      "OPENFILE %f"
  42.  
  43.                 iv)  GoToLine - edit this string gadget to contain
  44.                      "GOTOXY1 1 %l"
  45.  
  46.         b) Now click on the "Use" gadget at the bottom of the window.
  47.  
  48. 2) Play with it, run a sample compile, etc. to see if everything is acting
  49. the way you expected it to.  Once you are satisfied it is OK, you will
  50. need to
  51.  
  52.     (If you are running AmigaOS 2.0+)
  53.  
  54.         1> copy env:sc/SCMSG envarc:sc
  55.  
  56.                 -OR-
  57.  
  58.     (If you are running AmigaOS 1.3 or less)
  59.  
  60.         1> copy env:sc/SCMSG sc:env
  61.  
  62. 3) If you normally start Textra from the command line (as opposed to
  63. clicking on an Icon on Workbench), you may wish to copy the ARexx scripts
  64. provided to your REXX: directory, as in
  65.  
  66.         1> copy scripts/SASC_Scripts/#?.textra rexx:
  67.  
  68. (Ed-note: The Textra Installer will install the SAS/C scripts if you wish).
  69.  
  70. Now, you're ready to go!  That's all the installation necessary to get the
  71. SAS/C compiler to use Textra in place of SE.
  72.  
  73. Of course, there are a few other things you might wish to do, such as
  74. being able to start the compiler from the editor, etc., but these are
  75. easily handled through ARexx scripts.  I have included a couple of example
  76. scripts to get you started.  Textra has a very rich set of ARexx commands,
  77. so it should be very easy for you to make it do whatever you want it to do
  78. with SAS/C (or almost anything else, for that matter!  :-).
  79.  
  80.         CTRLB.textra    -       'B'uild current project.  This is the easy
  81.                                 way to restart the compiler after you have
  82.                                 made changes to the source.
  83.         CTRLF.textra    -       'F'ind current symbol.  Similar to the
  84.                                 script provided with SE, this will allow
  85.                                 you to place the cursor on a C symbol
  86.                                 (such as 'strlen', et. al.), and GSTs will
  87.                                 be searched for that symbol, with a new
  88.                                 window popping up with the file that
  89.                                 symbol is defined in if found.
  90.         CTRLN.textra    -       Step to 'N'ext compiler error/warning.
  91.         CTRLP.textra    -       Step to 'P'revious compiler error/warning.
  92.  
  93. ------------------ SCMSG Data File ------------------------
  94. LEFT 0
  95. TOP 11
  96. WIDTH 639
  97. HEIGHT 55
  98. NOHIDDEN
  99. NOREXXONLY
  100. NOAUTOEDIT
  101. PORTNAME TEXTRA
  102. EDITCOMMAND Work:Utilities/Textra/Textra %f
  103. GOTOFILE OPENFILE %f
  104. GOTOLINE GOTOXY1 1 %l
  105. NOPUBSCREEN
  106. ------------------ end of SCMSG Data File -----------------
  107.