如何在子类的scaladocs中重写@define

我找到了，但它们没有深入到任何深度

我试图做的是以一种通用的方式在基类/特征中编写文档，使用

@define

d变量，以便生成的文档中针对子类的措辞有意义

我已经将这一点提炼为一个例子，说明我本希望能够实现的目标，但没有：

/**
  * @define Word base-word
  */
class DocTestBase {

    /** Does a $Word
      *
      * @return
      */
    def foo = 1
}

/**
  * @define Word subclass word!
  */
class DocTestSubclass extends DocTestBase

有了以上内容，我希望为

DocTestSubclass#foo

生成的文档会说“Does a subclass word！”，但正如您在下面看到的，它不会

FWIW我也在Scala 2.12上尝试过，但结果是一样的

---

我怎样才能让它像我期望的那样工作？这是scaladoc中的一个bug吗？

看起来它仍然是一个未解决的问题：