diff --git a/WHATSNEW.txt b/WHATSNEW.txt
index 56db709..3ae60a9 100644
--- a/WHATSNEW.txt
+++ b/WHATSNEW.txt
@@ -1,8 +1,25 @@
+CHANGES
+
+- Symbol Tables and Templates are now first-class objects in their own
+  right (classes 'SymbolTable' and 'Template' respectively).  This
+  means API will not be compatible with programs built using previous
+  versions of 'tconfpy'.  You must now pass/receive objects of the
+  appropriate type rather than just dictionaries as was previously the
+  case.
+
+- The 'RetObj' object has been removed.  Objects of type 'SymbolTable'
+  are now returned.
+
+- Significant internal code resturcturing to encasulate parse-related
+  data structures into the 'Symbol Table' object.  This eliminated
+  most of the global variables.
+  
+
 NEW FEATURES
 
-- Added the 'CallingProgram' API keyword parameter.  This
-  allows the calling program to change the program name
-  embedded in every message produced during the parse.
+- Added the 'CallingProgram' API keyword parameter.  This allows the
+  calling program to change the program name embedded in every message
+  produced during the parse.