在kotlin中生成方法或类注释

Question

我正在使用Android Studio 3.0.1。我可以点击fix doc comment在Java中快速插入方法的注释，但在Kotlin中无效。我该如何解决？

Answer 1

当您在@内输入kdoc时，您会看到@param自动完成，@param后您自动完成查看所有参数，目前您无法在一次点击内完成所有参数。

提及Kotlin中的/** */条评论kdoc，而不是javadoc。

Answer 2

Kotlin尤其是KDoc鼓励使用不同的文档样式。正如本discussion所述：

  

原因是我们发现，与传统的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, R> T.let(block: (T) -> R): R