improve scaladoc comment