2i: improve JavaDoc.