More documentation updates.

TODO

@@ -11,7 +11,9 @@ remain to be cleaned up:
   in playermove() is particularly horrible, jumping backwards into the
   middle of a loop.
 
-* The way return values from handlers such as 2012 trigger side effects
-  based on global state is nasty.
+* The program is still pretty much typeless - full of magic numbers being
+  sliced and diced in cryptic ways.  Some attempt has been made to introduce
+  semantic types, but the job is barely started.
+
 
 

notes.adoc

@@ -122,4 +122,8 @@ ways:
 * The code still has an unfortunately high density of magic numbers - in
   particular, numeric object and room IDs.
 
+* The code is still mostly typeless, slinging around machine longs
+  like a FORTRAN or BCPL program.  Some (incomplete) effort has been made
+  to introduce semantic types.
+
 // end