Review this javadoc please.