This file is a library of swap_in, swap_out, is_swapped_in declarations.
It is arranged so that the declarations may be copied from this file and 
pasted into the .mem file being constructed in a text editor.
The format of each record in the file is:

/* comment */
,
       SWAP_IN =
       ...
      
      ^ last line actually ends here (contains 6 spaces)

Records are (sometimes) separated by a single blank line.

Assuming that the space declaration to be ugraded with this information
looks something like:

   SPACE memory_space PAGE 0:
      (OVERLAY      = memory_space):

1. find the appropriate record by matching the SPACE semantics to the comment
2. paste the comment above the SPACE declaration.
3. copy from the comma on the line below the comment
   to the last line (contains 6 spaces) to between the 
   OVERLAY space and the "):"


The result looks like:

   /* comment */
   SPACE memory_space PAGE 0
      (OVERLAY      = memory_space,
       SWAP_IN =
       ...
      ):

Notes on bits manipulated during swap in/out:

NAME     BITS ORMASK ANDMASK REGISTER           HARDWARE
====     ==== ====== ======= ========           ========
MP/NMC   11   0800   F7FF    ST3                all


//**********************************************************************
// all C55x cores
//**********************************************************************

   /* MP=0 */
,
       SWAP_IN =
         "DEBUG_Global(""old_ST3"" ) = ST3;"
         "ST3   = (ST3 & 0xF7FF; /* MP=0 */"
       SWAP_OUT =
         "ST3   = DEBUG_Global(""old_ST3"" );"
       IS_SWAPPED_IN =
         "((ST3    & 0x800) == 0x000)   /* MP==0 */" 
      
   /* MP=1 */
,
       SWAP_IN =
         "DEBUG_Global(""old_ST3"" ) = ST3;"
         "ST3   = (ST3 | 0x800; /* MP=1 */"
       SWAP_OUT =
         "ST3   = DEBUG_Global(""old_ST3"" );"
       IS_SWAPPED_IN =
         "((ST3    & 0x800) == 0x800)   /* MP==1 */" 
      
