GENERAL - javadocs for some engine classes