文档模板生成kotlin

之前在Android Studio中工作，如果在函数之前，我把/ **和回车，然后我自动生成的下一个文档，注释描述参数，返回值等

/** * @params a * @return */ int f(int a) { return a; } 

当我开始在Android Studio中使用Kotlin时，我试图生成一个类似的模板，它生成没有返回，参数等的空白模板。

  /** * */ fun f(a: Int) { return a } 

我安装了Dokka并试图在Android Stuio中设置它，但是没有奏效。 如何在Android Studio中为Kotlin配置类似的模板生成？

Answer 1

Kotlin，特别是KDoc鼓励不同的文档风格。 正如在这个讨论中所述 ：

原因在于我们发现，参考文档文本中的参数名称可以编写比传统的javadoc风格更简洁，更易读的文档，其中每个参数都记录在单独的标签中 。 因此， 默认情况下 ， 我们不会生成带有参数名称的模板 。 （D. Jemerov，Kotlin in Action Author）

下面是let的一个例子，它是标准库的一部分：

 /** * Calls the specified function [block] with `this` value as its argument and returns its result. */ @kotlin.internal.InlineOnly public inline fun  T.let(block: (T) -> R): R