Updating my specification file.  It also includes some rough notes