JavaDoc updates and corrections phase 1