mostly javadoc