Added or updated javadocs and comments, added entity utilitiy methods

Signed-off-by: Irmo van den Berge <bergerkiller@gmail.com>