some automatic javadoc generation (correct this time)