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

Question

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

考虑一个类，例如:

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()]]

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