为什么scala文档缺少方法?

时间:2014-10-24 05:34:35

标签: scala documentation

我一直在努力学习scala。我注意到的一件事是文档的质量。他们似乎错过了很多方法。这是故意的吗?我觉得我错过了一些东西,因为它们不会那么糟糕。

例如:

Blog post on reading files with scala. 博客文章建议使用scala.io.Source.fromFile(..)方法来读取文件。它提供了一个迭代器。看起来非常好用。我希望更好地理解课程,所以我转到scala.io.Source上的scala文档。

没有文档在哪里显示scala.io.Source.fromFile(..)的方法。当我进入我的IDE时,它会尝试自动完成Source.fromFile(..),它甚至可以在代码中使用。

在我尝试使用scala的数据库api之前,这发生在我身上。我错过了什么吗?是否有一个提示这种方法的秘密按钮?我没有意识到,我的一生都是盲目的吗?或者scaladocs真的很糟糕吗?

1 个答案:

答案 0 :(得分:8)

fromFile不是 class Source的方法,它是 object Source的方法。即你不能写

val source: Source = ...
source.fromFile(...)

您正在查看该类的文档,该文档未列出对象的方法。 对象文档的链接是位于顶部类名附近C的圆圈。