scala - 在Scaladoc中，如何链接到同一个类中的方法？

Question

在同一类中创建指向方法的链接的正确方法是什么？ Scaladoc 文档没有这方面的示例。

考虑一个类，例如：

package controllers

// import ...

class AccountController extends Controller with Secured {

  def current = Authenticated() { request =>
    // ...
  }

  /**
   * See [[current]] for an endpoint that...
   */
  def findAll = Authenticated() { request =>
     // ... 
  }

}

在 IntelliJ IDEA 的“快速文档”弹出窗口中，所有这些都显示为红色：

• [[current]]
• [[#current]]
• [[AccountController.current]]
• [[AccountController#current]]
• [[controllers.AccountController.current]]

这确实显示为蓝色：

[[controllers.AccountController#current]]

所以我想这是正确的，但是没有更简单但正确的方法吗？

Answer 1

您的示例的正确方法是：

[[controllers.AccountController#current()]]

尽管您不应该在代码中添加这些，但对于没有参数的函数，空括号在这里是必需的。您还必须在任何地方使用完全限定的名称，这意味着它应该包含包、类名、标签和方法名。

Answer 2

我不确定它何时修复，但我使用的是 IntelliJ IDEA 版本 2020.3，它适用于我：

/**
 * See [[current]] for an endpoint that...
 */