Updates to the package hierarchy and entity classes.  Mostly updated
comments for the JavaDoc.  Still no real functionality yet.