home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 454.lha / APS_v1.0 / APS.docs < prev    next >
Text File  |  1990-12-04  |  10KB  |  182 lines
  1. November 24, 1990, Portage La Prairie, Manitoba, Canada.
  2.  
  3. Aztec_C Power Steering (APS V0.9b) (©1990 Sylvain Duford)
  4.  
  5. Designed with CanDo V1.022 (©1989 INOVAtronics Inc.)
  6.  
  7. Freely re-distributable as long as you leave this archive intact.
  8.  
  9.         WARNING: THIS IS A BETA VERSION, IT HAS ONLY BEEN TESTED ON
  10.                 MY SYSTEM. I DECLINE ANY RESPONSIBILITIES FOR ANY 
  11.                 PROBLEMS OR DAMAGES INCURED WHILE USING APS.
  12.                 
  13.  
  14. INTRODUCTION:
  15.  
  16.         Hello fellow Aztec C users! If you've been drooling over the 
  17.         new SAS C intuitionized interface, here is my first attempt at
  18.         producing something similar for Aztec C V5.0. APS will allow you
  19.         to select all the switches for CC,AS,LN,DB,SDB and MAKE simply by
  20.         clicking on a graphic screen. No more looking up the manual! APS
  21.         will also let you set the Environment variables and will show you
  22.         compilation errors directly in the source. You can also edit the
  23.         MakeFile and launch CC,AS,LN,DB,SDB,Make and your own editor with a
  24.         click of the mouse. You can also control APS from your editor via
  25.         ARexx, but ARexx is not required to use APS.
  26.         
  27.  
  28. REQUIREMENTS:
  29.  
  30.         Any Amiga with at least 1 Meg of RAM and 2 floppies, 2 megs and a
  31.         hard drive highly recommended. You will also need DeckBrowser, a
  32.         Freely Redistributable utility from the authors of CanDo, available 
  33.         on most BBS's.
  34.         
  35.  
  36. INSTALLATION:
  37.  
  38.         You can put APS in any directory but I like to put it in my 
  39.         Aztec/bin directory. You will require DeckBrowser in your C:
  40.         directory for APS to run properly. You should also put the
  41.         APS.defaults file in your s: directory. The files with the .rexx
  42.         extension are example macros of how to control APS from your
  43.         editor, if you have ARexx and wish to use this feature, you should
  44.         put those in your rexx: directory. APS will also require the
  45.         following files in the C: directory; newcli, endcli, run and
  46.         delete. Also make sure you have a T: directory assigned somewhere.
  47.         
  48.         To start APS, simply type 'Run >nil: APS' in a CLI or SHELL. I
  49.         personnaly start APS from an IconX script that also opens a SHELL 
  50.         window. This allows me to test my compiled programs, or to do other
  51.         CLI work like using DIFF or GREP. 
  52.  
  53.         After starting APS for the first time, you should immediately click 
  54.         on 'SET ENVIRONMENT VARIABLES' and enter the proper paths for
  55.         CLIB, INCLUDE and CCTEMP, click on 'DONE' once you are finished. 
  56.         You should then click on APS' Defaults ->'SET' and enter the proper
  57.         paths for your BIN and SOURCE CODE directorys as well as the 'run'
  58.         command you want APS to use (ie run or runback). Click on 'DONE'
  59.         again and then select the EDITOR 'OPTIONS' gadget. This will let
  60.         you enter the full Path and name for your own text editor. Click on
  61.         'DONE' and then on APS' Defaults 'SAVE' to save these new settings
  62.         to disk. You should now be set to start using APS.
  63.         
  64.         
  65. HOW TO USE APS:
  66.  
  67.         If you are already familiar with Aztec C 5.0, then using APS should
  68.         be trivial. You can enter the name of the source file you want to
  69.         work with, in the SOURCE -> text field. After entering 'RETURN', APS
  70.         will translate this into the standard object file and program names
  71.         based on the source name minus the extension. If you wish you can
  72.         modify the last 2 names, but be sure to use 'RETURN' to get out of
  73.         those text fields so that APS can register the changes.
  74.         
  75.         You can now control all options for CC,AS,LN,MAKE,DB and SDB by
  76.         clicking on the appropriate 'OPTIONS' button. Once in one of those
  77.         control panels you can click on the white buttons to the left of
  78.         the switches you want to turn ON. When an option is ON then it's 
  79.         button will show a check mark, clicking on that button again will
  80.         turn the switch back to OFF. Some switches also require that you 
  81.         enter some text, in those cases, after turning the switch to ON, 
  82.         the appropriate text field will be activated and the cursor placed 
  83.         in it. Once again, be sure to type 'RETURN' when you are done 
  84.         typing text in order to let APS register the changes.
  85.         
  86.         Some control panels (like the compiler's) have further options
  87.         available by clicking on the appropriate buttons. As you must have 
  88.         noticed, the complete command line options are shown at the bottom 
  89.         of each control panel. You can also click in that text field and
  90.         directly edit the cmd line options. Once you are satisfied with the
  91.         options you selected, clicking on 'DONE' will bring you back to the
  92.         main control panel. If instead you click on 'CANCEL' or on the
  93.         window's CLOSE gadget, these options will revert to their initial
  94.         settings before going back to the main control panel. If you now
  95.         click on the APS' DEFAULTS 'SAVE' button, all the selected options
  96.         will be saved to disk, and automatically reset next time you start
  97.         APS.
  98.         
  99.         When you are in MAKE's control panel, you can click on 'EDIT
  100.         MAKEFILE' to edit the current MakeFile. You can also enter some
  101.         command line macros and a list of files to make. If no files are
  102.         listed, make will 'make' the first file encountered in the
  103.         MakeFile.
  104.         
  105.         The debugger's control panel only allows you select which debugger
  106.         to use, ie SDB, SDBF or DB. If you select one of the 2 SDBs, you
  107.         will be given a chance to enter further cmd line arguments before
  108.         the debugger is launched.
  109.         
  110.         You can now launch any of those commands by simply clicking on the
  111.         appropriate 'LAUNCH!' buttons. These commands will use the
  112.         appropriate file name based on those you entered on the main
  113.         control panel.
  114.         
  115.         If you get any compiler errors, and if you have set the -wq switch
  116.         in the COMPILER/WARNINGS control panel, you can now click on the
  117.         'SHOW/EDIT ERRORS' button. This will bring up a simple text editor
  118.         with your source file displayed in it. This editor will also place
  119.         the cursor on what the compiler believes to be the first error, and
  120.         a description of the error will be shown at the top of the window.
  121.         You can now select one of the menu otpions or equivalent hot keys
  122.         or click on the appropriate buttons to move to the next or previous
  123.         errors. You can also SAVE the edited source file or select QUIT.
  124.         Choosing QUIT will NOT save the source file, clicking on the 
  125.         window's close gadget is equivalent to clicking on 'SAVE & CLOSE'.
  126.         
  127.         If you prefer to use the QuickFix option in concert with the Manx's
  128.         Z Editor, just enter the appropriate options in the CCOPTS and
  129.         CCEDIT environment variables.
  130.         
  131.         
  132. CONTROLLING APS FROM YOUR EDITOR:
  133.  
  134.         If you have ARexx installed on your system and own an ARexx
  135.         compatible Editor, you can control APS from inside that editor. In
  136.         order to do this, simply write some ARexx macros that will send the
  137.         appropriate commands to the ARexx port 'APSRexx' (Case sensitive).
  138.         The allowable commands are:
  139.                                    Assemble,    starts AS
  140.                                    Compile,     starts CC
  141.                                    Debug,       starts DB,SDB or SDBF
  142.                                    Edit,        starts your EDITOR
  143.                                    Errors,      starts APS' Errors Editor
  144.                                    Link         starts LN
  145.                                    Make         starts Make
  146.  
  147.         All of the above commands except 'Errors' will accept a file name
  148.         as a parameter (ie; 'Compile' 'Main.c') If no file name is
  149.         specified, APS will use the appropriate one as already entered 
  150.         on the main control panel. Make will accept several filenames to be
  151.         'made' but as one parameter (ie; 'Make' 'Main Calc Prog'). The 
  152.         'Errors' command always defaults to the last Source File compiled 
  153.         or if none was compiled during the current session, to the Source 
  154.         File name entered on the main control panel.
  155.         
  156.         These commands behave exactly like if you had clicked on the
  157.         corresponding buttons of the main control panel.
  158.         
  159.         If you are still unsure of how to use these commands, look at the
  160.         example macros included in this archive (.rexx files).
  161.                  
  162.                  
  163. CONCLUSION:
  164.  
  165.         That's it for this short documentation file on APS. This is only
  166.         V0.9 and it is untested on any other systems than mine. I have tried
  167.         to design it so it would work on any system, but yah never know! So
  168.         please send me any bug/incompatibilities reports, and/or suggestions
  169.         to make this program better. You can reach me on CompuServe's 
  170.         Amiga Forum or  EMAIL, my ID# is 76056,1655. You can also write
  171.         to me at:
  172.         
  173.                 Sylvain Duford
  174.                 122, 12th Street N.W.
  175.                 Portage La Prairie
  176.                 Manitoba, Canada
  177.                 R1N-2T1
  178.                 
  179.         I'd like to thank INNOVAtronics Inc. for producing CanDo, a truly
  180.         amazing package that made it possible to design this user interface
  181.         in days instead of months.      
  182.