Javadoc updates and annotations

Signed-off-by: Oleg Nenashev <o.v.nenashev@gmail.com>