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

Class 如何在文档中引用实例方法?,class,scala,object,methods,documentation,Class,Scala,Object,Methods,Documentation,编写文档时如何引用实例字段 考虑以下代码: object Foo { val foo = 42 } class Foo { val foo = 42 } 在Java中,“静态”方法使用Foo.Foo,实例方法使用Foo#Foo 但是在Scala中,路径依赖类型和 class Foo { class foo def foo = 42 } 是法律法规,所以我不能明确地提及它 这是什么样子的 很难。也许你喜欢英语,比如《代码》中的Foo's Foo?我错过了#这个模棱两可的词。不

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

考虑以下代码:

object Foo {
  val foo = 42
}

class Foo {
  val foo = 42
}
在Java中,“静态”方法使用
Foo.Foo
,实例方法使用
Foo#Foo

但是在Scala中,路径依赖类型和

class Foo {
  class foo
  def foo = 42
}
是法律法规,所以我不能明确地提及它


这是什么样子的

很难。也许你喜欢英语,比如《代码》中的Foo's Foo?我错过了
#
这个模棱两可的词。不过,这仍然是我的首选,因为歧义只存在于没有上下文的情况下。当提及类型时,
#
有一个含义。当引用一个值或方法时,
#
有另一个值或方法


由于类型和方法/值不共享名称空间,因此我不认为这里的模糊性是相关的。

我也使用#来实现这一目的。主要问题是链接到ScalaDoc的相应URL应该是什么样的?没有办法将“上下文”嵌入URL。。。除了选择一个明确的符号。如果我们已经发明了一个符号,我们也可以在文档中使用它。@soc好吧,
Foo.Foo
在ScalaDoc中指的是什么?到
对象foo
中的
键入foo
,或到
对象foo
中的
定义foo
?这个问题已经存在。考虑到这种情况只会发生在人们如此粗鲁以至于用相同的标识符命名类型和非类型成员时,我建议我们忽略它——或者同时解决这两个问题。此外iirc,
#
在URL中有特殊的含义,所以我们不能在URL上真正使用它,是吗?当然,那么什么是好的解决方案呢?看来我们已经用完了可以使用的符号。。。