class - 如何在文档中引用实例方法？

Question

编写文档时如何引用实例字段？

考虑这个代码:

object Foo {
  val foo = 42
}

class Foo {
  val foo = 42
}

在 Java 中，可以使用 Foo.foo对于“静态”方法和 Foo#foo对于实例方法。

但是在 Scala 中 #已经被用于路径依赖类型和

class Foo {
  class foo
  def foo = 42
}

是合法的代码，所以我不能明确地引用它。

是否有一些约定，这应该是什么样子？

Answer 1

艰难的。也许像英语，如 Foo's foo ?我错过了 # 的歧义.不过，这仍然是我的首选，因为歧义只存在于没有上下文的情况下。引用类型时，#有一个意思。引用值或方法时，#有另一个。

由于类型和方法/值不共享命名空间，因此我认为此处不存在相关性的歧义。