Generazione di commenti metodo/classe Kotlin

Question

Come si generano commenti per i propri metodi/classi? Semplicemente digitando:

/** 

E spingendo enter non sembra di lavorare in IntelliJ IDEA 2016.1.3

Sembra Dokka è sostituita KDOC, ma perché c'è alcun supporto in IntelliJ? O mi sta sfuggendo qualcosa?

Chiarimento: quando si digita/** + entrare, questo viene generato:

/** 
* 
*/ 

ma mi chiedo il motivo per cui la generazione di @param e altri non vengono aggiunti (come IntelliJ fa per Java) . Queste annotazioni sono utilizzate per la documentazione del codice Kotlin così (https://kotlinlang.org/docs/reference/kotlin-doc.html)

Answer 1

Il @param e altri tag non vengono generati perché lo stile di documentazione consigliata per Kotlin è quello di fare riferimento a nomi dei parametri dal doc commento testo utilizzando la sintassi [foo], piuttosto che per documentarli utilizzando i tag espliciti @param. Puoi controllare lo Kotlin standard library documentation per vedere come viene usato questo stile.