Как документировать параметр первичного конструктора с помощью Kotlin Dokka

Предположим, что существует класс, в котором у первичного конструктора есть параметр param который я бы хотел разрешить (связанный с фактическим параметром) в блоке doc класса.

 /** Class A does something using [param]. @constructor constructs A with [param]. */ class A (param: Int) 

Тем не менее, параметр надписи выделяется IDE, говорящим, что он не может решить символ param .

Фактически, dokka правильно находит параметр, если вы ссылаетесь на [param] в абзаце @constructor , вы можете проверить это, проверив URL-адрес, который появляется в собранных документах, который выглядит так:

 file:///.../some.package/-a/-init-.html#some.package.A$<init>(kotlin.Int)/param 

По-видимому, предупреждение о неразрешенной ссылке – проблема с поддержкой IDE для KDoc. Сообщите об этом в kotl.in/issue .

Другой вариант – использовать @param в классе KDoc:

 /** * Class A does something using [param]. * @param param means something special. */ class A (param: Int)