java doc updates - in progress