用KDoc表示常数的参考值

Question

我的项目中有一个类似于以下内容的object

object UrlUtils {

    private const val PARAM = "whatever"

    /**
     * Method that appends the [PARAM] parameter to the url
     */
    fun appendParameter(url: String) {
        // ...
    }

}

正如您可以看到的那样，我希望在PARAM方法的KDoc注释中引用appendParameter字段的值，但是当查看注释时，我没有看到实际的值，而只看到了字段的名称。

方法，将PARAM参数追加到url。

我想要的：

方法，该方法将任何参数附加到url。

在Javadoc中，这是通过使用{@value PARAM}来实现的，但是在KDoc中似乎没有类似的地方。即使是自动代码转换器也保留了旧的Javadoc。

所以我的问题是:我是遗漏了什么，还是KDoc/Dokka缺少了这个功能？

Answer 1

目前，{@value}标记不受KDoc支持。

请求这一点的最接近的问题是#488，因此您可以对其进行投票和/或评论。