Added some javadoc

Added some javadoc to some engine stuff that is frequently used in modules.
Please check for correctness.