added 1.2.2 JavaDoc