readded final javadocs (mistake in last commit)