定义scaladoc宏以便在伴生对象中重用

我正在努力了解如何做到这一点。例如

我的印象是，这应该会产生一个文档，其中既有对trait和伴生对象的描述

a Consumer简化了资源管理…

，也显示了

apply

方法和

trait

中的两种类型参数描述

但是宏在trait中似乎不可用。在正确记录对象的同时，trait文档只显示宏名称

$DESCR

，

$KEY

，

$VALUE

/** $DESCR
  *
  * @define DESCR
  * A `Consumer` simplifies resource management...
  *
  * @define KEY
  * the key type
  *
  * @define VALUE
  * the value type
  */
object Consumer {
  /** Creates a new consumer
    *
    * @tparam A       $KEY
    * @tparam B       $VALUE
    */
  def apply[A, B](): Consumer[A, B] = ???
}

/** $DESCR
  *
  * @tparam A $KEY
  * @tparam B $VALUE
  */
trait Consumer[-A, +B]