home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Programming / C / SASC6571.LZX / READ.ME < prev    next >
Encoding:
Text File  |  1993-10-01  |  4.9 KB  |  105 lines
  1. *************************************************************************
  2.  
  3. SAS/C® Version 6.50 should be installed from the WorkBench.  Double-click
  4. on the "Install_SASC_6.50" icon to run the installation program if you
  5. have not already done so.
  6.  
  7. **************************************************************************
  8.  
  9.    1. The directories SC:EXAMPLES and SC:EXTRAS contain useful
  10.       utility programs and examples of techniques that may prove
  11.       useful to you.  Not all of these utilities are described in
  12.       the manual.
  13.  
  14.    2. Since the compiler's executables are now AmigaDOS shared
  15.       libraries, they remain in memory after your compile
  16.       finishes.  They will be automatically flushed out of
  17.       memory if they are not in use and some other program
  18.       needs the memory.  However, if you run out of fast
  19.       memory, the operating system starts using chip memory
  20.       before flushing the libraries.  Chip memory is much
  21.       slower than fast memory on Amigas with faster processors,
  22.       so this may slow down your program.
  23.  
  24.       If you think this is happening to you, and you are running
  25.       AmigaDOS 2.0, use the AVAIL command as follows to flush any
  26.       shared libraries before running your program:
  27.  
  28.          avail flush
  29.  
  30.    3. The format of bitfields changed in Version 6.0.  If you have a
  31.       program that ran under version 5.10 or earlier that depends on the
  32.       order of bits in bitfields, it will no longer work.
  33.  
  34.    4. By default, when you include the file proto/exec.h you get "syscall"
  35.       pragmas for all exec.library functions.  Another set of pragmas exists
  36.       for exec that use the "libcall" method via the library base SysBase.
  37.       Either set of pragmas will work.  The "syscall" pragmas find the
  38.       address of exec.library by looking at memory location 4.  The
  39.       "libcall" pragmas find it by looking at the external variable
  40.       "SysBase".
  41.  
  42.       On Amigas with 68020 and higher processors, it is significantly faster
  43.       to use the "libcall" pragmas.  To do this, define the preprocessor
  44.       symbol "__USE_SYSBASE" on the command line or by using a #define
  45.       statement.  If you do this, make sure you include the file
  46.       <proto/exec.h> rather than <pragmas/exec_pragmas.h>.  If you do this
  47.       and you are not using one of the SAS/C supplied startup modules, you
  48.       will have to initialize the variable SysBase yourself as follows:
  49.  
  50.          struct ExecBase *SysBase = *(struct ExecBase **)4;
  51.  
  52.    5. If you are using a program or disk handler which compresses files on
  53.       your drive (such as EPU, XFH-Handler, etc.), be aware that these
  54.       programs can require large amounts of RAM to decompress.  If you start
  55.       seeing "*** Freeing Resources" messages from the compiler, this could
  56.       be the problem.
  57.  
  58.       There are currently only two ways to work around this problem: don't
  59.       use the compression handler for compiler files (such as include: files,
  60.       etc.), or use the MEMSIZE switch to cause the compiler to use less
  61.       memory for itself.
  62.  
  63.    6. Due to problems using the SetFunction() function under AmigaDOS 1.3,
  64.       CPR does not have the ability to set deferred breakpoints in shared
  65.       libraries or devices under 1.3.  You can still debug a shared library
  66.       or device by stepping into it and using the SYMLOAD command to load
  67.       the debugging information.
  68.  
  69.    7. At the last minute, a new feature was added to the libraries as a
  70.       bonus for those of you who actually read this file!  Two external
  71.       variables, _WBArgc and _WBArgv, and some autoinitializer code to
  72.       initialize them are now defined in the link libraries.  If your
  73.       program is invoked from WorkBench, _WBArgc and _WBArgv contain
  74.       values corresponding to the (argc, argv) parameters to main().
  75.       These values are derived from the WBStartup message.  Include
  76.       the file <dos.h> to use them.
  77.       
  78.       _WBArgc is an int containing the number of meaningful entries
  79.       in _WBArgv.
  80.       
  81.       _WBArgv is a char ** containing a list of arguments.  _WBArgv[0]
  82.       is always the name of the program being run.  Any ToolTypes set
  83.       in the program's icon follow;  each ToolType is a seperate 
  84.       entry in the _WBArgv array.  Finally, any additional icons 
  85.       selected with SHIFT-CLICK or SHIFT-DOUBLE-CLICK show up as
  86.       filenames in the _WBArgv array.  A good way to use this new
  87.       feature is to add the following code to the beginning of 
  88.       your main() function:
  89.  
  90.          if(argc == 0)
  91.          {
  92.             /* Invoked from WorkBench... use WorkBench arguments  */
  93.             /* Make sure <dos.h> was included earlier in order to */
  94.             /* declare _WBArgc and _WBArgv.                       */
  95.             argc = _WBArgc;
  96.             argv = _WBArgv;
  97.          }
  98.  
  99.       With this code in place, your code will probably be able to 
  100.       run without being aware that it was actually invoked from
  101.       WorkBench.
  102.  
  103.       Source code for the autoinit routine is in SC:SOURCE/WBARGS.C.
  104.  
  105.