we use the convention to prefix the scaladoc description with

    /**
     * Java API: ...