Я нашел документы для макроса @define
scaladoc , но они не углубляются в детали.
Я пытаюсь написать документацию в базовом классе /универсальный способ, с @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
скажет: «Есть слово подкласса!», но, как вы можете видеть ниже, это не так.
![enter image description here](https://i.stack.imgur.com/UQ5ma.png)
FWIW Я также пробовал это на Scala 2.12, но результат тот же.
Как мне заставить это работатькак я ожидаю?Это ошибка в скаладоке?