actually implement the logic of the javadoc...