Cómo documentar un parámetro de constructor primario con Kotlin Dokka

Digamos que hay una class cuyo constructor primario tiene el parámetro param que me gustaría resolver (vinculado al parámetro real) dentro del bloque de documento de la class.

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

Sin embargo, el param inscripción se destaca por el IDE que dice que no puede resolver el param .

En realidad, dokka encuentra correctamente el parámetro si lo reference con [param] en el párrafo @constructor , puede verificarlo inspeccionando la URL que aparece en los documentos ensamblados, que se ve así:

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

Aparentemente, la advertencia sobre una reference no resuelta es un problema con el soporte de IDE para KDoc. Por favor repórtalo en kotl.in/issue .

Otra opción es usar @param en la class KDoc:

 /** * Class A does something using [param]. * @param param means something special. */ class A (param: Int) 
  • Dokka: omita la generación de javadoc para los packages pnetworkingeterminados de Android
  • Suprima las quejas de Dokka sobre "No hay documentation para com.foo.Bar $ toString ()"?