
NEWLY ADDED FEATURES
--------------------

NOTE: the newest features are listed first.


** >>> Version 3.1E released


** Detection of REGISTER saving and restoring during interrupt

   CC5X will AUTOMATICALLY check that the registers W, STATUS,
   PCLATH and FSR are saved and restored during interrupt.

   The details about this is found in file 'int16Cxx.h'.

   The error and warning messages printed can be removed:

     #pragma interruptSaveCheck  n  // no warning or error
     #pragma interruptSaveCheck  w  // warning only
     #pragma interruptSaveCheck  e  // error and warning (default)


** >>> Version 3.1D released


** Better variable overlapping

   Variables can overlap parts of another variabel, table or
   structure. Multiple levels of overlapping is allowed.

     char aa @ ttb[2];   // char ttb[10];
     bit  ab @ aa.7;     // a second level of overlapping
     bit  bb @ ttb[1].1;
     size2 char *cc @ da.a;  // 'da' is a struct
     char dd[3] @ da.sloi[1].pi.ncup;
     uns16 ee @ fx.mid16;  // float32 fx;
     TypeX ii @ tab;   // TypeX is a typedef struct


** Using expressions to define addresses

   An expression can now define the address of a variable. This
   makes it easier to move a collection of variables.

     char tty @ (50+1-1+2);
     bit  tt1 @ (50+1-1+2+1).3;
     bit  tt2 @ (50+1-1+2+1).BX1;   // enum { .., BX1, .. };


** Address operations

   The logic for checking address operations is enhanced. The
   supported operations are:

     ADR + EXPRESSION (VARIABLE/CONST)
     ADR - EXPRESSION (VARIABLE/CONST)
     ADR & 0xFF;   // LSB : least significant 8 bits
     ADR % 256;    // LSB : least significant 8 bits
     ADR >> 8;     // MSB : most significant bit(s)
     ADR / 256;    // MSB : most significant bit(s)

   Example:
     FSR = &table[3] & 0xFF;
     IRP = &table[3] >> 8;   // on devices using 9 bit address

   A warning is printed when using other address operations (for
   example &p | 3). This warning is changed to an error when using
   relocatable assembly (option -r).


** Combining inline integer math and library calls

   It is possible to force the compiler to generate inline integer
   math code after a math library is included. This may be useful
   when speed is critical or in the interrupt service routine.
   Functions with parameters or local variables are not reentrant
   because local variables are mapped to global addresses, and
   therefore the compiler will not allow calls from both main and
   the interrupt service routine to the same function.

     uns16 a, b, c;
     ..
     a = b * c;    // inline code is generated
     ..
    #include "math16.h"
     ..
     a = b * c;    // math library function is called
     ..
    #pragma inlineMath 1
     a = b * c;    // inline code is generated
    #pragma inlineMath 0
     ..
     a = b * c;    // math library function is called


** Inline type modifier on math operations

   It is possible to combine inline integer math and math library
   functions without making a special purpose math library. This is
   done by stating that the selected operations are inline BEFORE
   the standard math library is included. It is optimal to use
   inline code when there is only one operation of a certain type.

     inline uns24 operator * (uns24 arg1, uns24 arg2);
     #include "math24.h"

   The math prototypes are found in the beginning of the standard
   math libraries. Just remember to remove the operator name before
   adding the inline type modifier.

   A warning is printed when there is ONE call to a unsigned integer
   math library function. The warning can be disabled by the -wm
   command line option.

   NOTE that the inline type modifier is currently IGNORED, except
   for the math operations.


** Detection of multiple inline math integer operations

   The compiler will print a warning when detecting more than one
   inline math integer operation of the same type. Including a math
   library will save code, but execute slightly slower. Note that
   assembly code inspection and type casts are sometimes needed to
   reduse the number of library functions inserted.

   The warning can be disabled by the -wi command line option.


** Reading program memory on more devices

   The compiler will now read program memory directly on devices
   having the predefined registers:

     PMDATA, PMADR,  PMDATH, PMADRH : 16C925/926, 16F73/74/76/77
     PMDATL, PMADRL, PMDATH, PMADRH : 16C717/770/771, 16C781/782

   The compiler will use computed goto (more code, but faster)
   instead of direct program memory reading when using:

     #pragma wideConstData 8192


** >>> Version 3.1C released


** cdata outside legal program and eeprom space is disabled

   CODE:   0x0000 - upper program limit
   EEPROM: 0x2100 - 0x21FF : eeprom data space

   The error message can be changed to a warning by using the -cd
   command line option.


