some javadocing