javadocing refactoring