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

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？我错过了 的含糊之处#。不过，这仍然是我的首选，因为只有在没有上下文的情况下才存在歧义。当提到一种类型时，#有一个含义。当引用一个值或方法时，#有另一个值或方法。

由于类型和方法/值不共享名称空间，因此我认为这里没有相关性。