correct javadoc
add methods to produce compilation warning