home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Programming / C / SASC6571.LZX / extras / ttx / Instructions < prev    next >
Encoding:
Text File  |  1996-12-24  |  7.2 KB  |  202 lines
  1.  
  2.                                TTX <=> SAS/C
  3.                                 Version 2.1
  4.  
  5. These macros and the accompanying TurboText definition file are all written
  6. by Kenneth Yarnall.  They may be freely distributed.
  7.  
  8. TurboText is a trademark of Oxxi, Inc..
  9. SAS/C is a trademark of SAS Institute.
  10. ---------------------------------------------------------------------
  11.  
  12.                              Table of Contents
  13.                              -----------------
  14.  
  15.                              I. Installation
  16.                             II. Using the menus
  17.                            III. Other keys
  18.                             IV. SetDefs.ttx
  19.                              V. Changes
  20.  
  21.  
  22. I. Installation
  23. ---------------
  24.  
  25. 1)  Place the supplied files as follows:
  26.  
  27.     o  Move the contents of the Rexx drawer to the REXX: directory on your
  28.        system.
  29.  
  30.     o  Move the contents of the Support drawer to the directory
  31.        TURBOTEXT:Support/.
  32.  
  33.     o  Move the file ENV/SC/SCMSG to ENVARC:SC/ *AND* to ENV:SC/.
  34.  
  35. 2)  To install the SASC menus under TurboText, do one of the following.
  36.  
  37.     o  Choose Prefs/Open Defs... (Right-Amiga-/ in the standard TurboText
  38.        setup) and select TTX_SASC.dfn in the file requester.  The two menus
  39.        that control the SAS/C 6.0 compiler should appear in TurboText's menu
  40.        strip.
  41.  
  42.     o  To make this a permanent addition to your system, insert the lines
  43.  
  44.          LINKS:
  45.           TURBOTEXT:Support/TTX_SASC.dfn
  46.  
  47.        to your Startup.dfn file.  Alternately, you can merge the contents of
  48.        TTX_SASC.dfn with Startup.dfn, or see the section below on
  49.        SetDefs.ttx.
  50.  
  51. 3)  To use the message browser, remember that you must set the "ErrorRexx"
  52.     option of the SAS/C compiler.
  53.  
  54. ---------------------------------------------------------------------
  55.  
  56. II. Using the menus
  57. -------------------
  58.  
  59. SAS/C
  60.  
  61.     Make Project... F6
  62.       This entry starts SCmsg if it isn't running, and issues a build
  63.       command in the directory of the file currently being edited.  SMake
  64.       will be run in that directory, and if you have the "ErrorRexx" option
  65.       set for the compiler, warnings and errors will appear in the message
  66.       browser.
  67.  
  68.     Compile File... ^F6    (Control F6)
  69.       This compiles the file in the current TurboText window.  SC is called
  70.       directly;  SMake is not used.
  71.  
  72.     Set Options... F7
  73.       Calls up SCOptions, first changing to the directory of the document
  74.       in the current TurboText window.  This allows you to set the compiler
  75.       options that will be used for the source file you are editing.
  76.  
  77.     Debug Program  ยป
  78.         CLI
  79.         WB
  80.       These allow you to execute CodeProbe on the executable associated
  81.       with the document in the current TurboText window.  Choose CLI to
  82.       have the program started in a CLI environment, WB to have it started
  83.       from the Workbench. The assumption made is that the program is in the
  84.       same directory as the file being edited, and is named similarly,
  85.       minus a ".c" suffix.  For instance, if you are editing
  86.       Work:MySource/Foo.c, this menu option will try to debug the program
  87.       Work:MySource/Foo.  Note that if there is no such program, CPR exits
  88.       harmlessly.
  89.  
  90. SCmsg
  91.  
  92.     Show Browser
  93.     Hide Browser
  94.     Clear Browser
  95.       These show the SCmsg message browser window, hide it, and clear of of
  96.       all messages, respectively.  They do not try to start SCmsg if it is
  97.       not running, and instead exit with an error.
  98.  
  99.     Current   F8
  100.     Previous  F9
  101.     Next     F10
  102.     First
  103.     Last
  104.       These navigate amongst the messages shown in the message browser's
  105.       window, using the macro ErrorStep.ttx.  They move the TurboText
  106.       cursor to the line indicated in the current, previous, next, first,
  107.       or last message, respectively.  If the error occurs in a source file
  108.       not currently loaded into a TurboText window, you are asked if you
  109.       want to load that file.
  110.  
  111.     Delete
  112.       Deletes the currently highlighted message from the browser's window.
  113.  
  114. ---------------------------------------------------------------------
  115.  
  116. III. Other keys
  117. ---------------
  118.  
  119.     CTRL-HELP
  120.       FunctionHelp.ttx is attached to this key by the supplied dfn
  121.       file.  Press that key while the cursor is over the name of a
  122.       standard library function name, and the SAS/C AmigaGuide help
  123.       system is invoked.
  124.  
  125.     ALT-C
  126.       The supplied dfn file (TTX_SASC.dfn) also attaches CommentBlk.ttx
  127.       to the key ALT-C.  This macro is supplied with TTX, and I found it
  128.       handy.
  129.  
  130. ---------------------------------------------------------------------
  131.  
  132. IV. SetDefs.ttx
  133. ----------------
  134.  
  135.   SetDefs.ttx is a little macro I whipped up some time ago that I thought
  136. I'd include here.  It is a "Poor Man's DataTypes";  it checks the extension
  137. of the file that you're loading, and opens an appropriate definitions file.
  138. The supplied version understands .c, .h, .cpp, .cxx, and .tex (you may want
  139. to change the last one, depending on your system).
  140.  
  141.   Any ARexx-aware programmer can glance at the script and see how to extend
  142. it to cover other extensions.  Note that the macro is slightly smart, in
  143. that it doesn't load a new def's file unless it thinks it needs to.
  144.  
  145.   To install SetDefs.ttx, drop it in REXX: and then modify the file
  146. TTX_Startup.dfn to contain the lines (in the MENU " Project " section):
  147.  
  148.   ITEM "Open..."     "O" ExecArexxString "OpenFile; Call 'rexx:SetDefs.ttx'"
  149.  
  150.   ITEM "Open New..." "Y"
  151.             ExecArexxString "OpenDoc FileReq MACRO 'rexx:SetDefs.ttx'"
  152.  
  153. (the last is all one line, albeit a long one).  This patches the open
  154. functions inside TTX so that the extensions are obeyed.  I also have
  155.  
  156.   ALT-D  ExecArexxString "SetClip('extension',''); Call 'Rexx:SetDefs.ttx'"
  157.  
  158. in the keyboard section, so that I can hit ALT-d to load the proper defs for
  159. the current file.
  160.  
  161.   Using SetDefs.ttx means that you don't have to Link TTX_SASC.dfn into your
  162. startup dfn file, as I outlined in the instructions above.  This keeps
  163. things a bit cleaner, I think.
  164.  
  165.   I find myself using this all the time.  When/if TTX windows become
  166. independent, such a macro can be much more powerful.
  167.  
  168. ---------------------------------------------------------------------
  169.  
  170. V. Changes
  171. ----------
  172.  
  173. 2.1
  174. ---
  175.   Cleaned up the code a bit (took a suggestion from Richard O'Sullivan and
  176. mod'ed out the common code into a few external routines).  Fixed a couple of
  177. multitasking holes in Middleman.rexx.
  178.  
  179.   Added support for public screens. SCOpts, SCMsg, and the console window
  180. that Compile.ttx opens all now follow TTX onto whatever public screen TTX is
  181. currently inhabiting.  SCMsg will actually hop around to follow TTX, so you
  182. can get them in a game of chase, if you like. :-)
  183.  
  184. 2.0 (not a general release)
  185. ---
  186.   Extensive rewrite of the scripts.  Added Middleman.ttx, so that clicking
  187. on the entries in the SCmsg window works.  Added some code to Build.ttx and
  188. Compile.ttx to check the state of the file you're working on, and ask if you
  189. want to save, etc., if it's needed.  Added some comments and generally
  190. cleaned.  Included SetDefs.ttx and FunctionHelp.ttx.
  191.  
  192. 1.1
  193. ---
  194.   Initial Public Release.
  195.  
  196. ---------------------------------------------------------------------
  197.  
  198. That is it!
  199.  
  200.   You may send questions/comments/improvements/bug reports to the author on
  201. BIX (kyarnall), and via internet mail at kyarnall@BIX.com.
  202.