updated JavaDoc, to prevent mistakes