2012-07-06 112 views
11

在功能进入斯卡拉2.10所有的各种不完整的名单,有各种提到的改进Scaladoc。但目前还不清楚哪些是哪些,哪些正在进行 - 例如,其中一个改进列​​表显示“修复Scaladoc”,并链接到各种拉取请求,其中一些被拒绝。Scala 2.10中的Scaladoc增加了哪些新功能?

任何人都可以总结Scala 2.9和2.10里程碑4之间实际上发生了什么变化,也许可以说明还有什么计划2.10本身?

另外,他们是最后要解决无法链接到方法的问题?例如。散落在我的代码,我有这样的事情:

/** 
* Reverse the encoding computed using `encode_ngram`. 
*/ 
def decode_ngram(ngram: String): Iterable[String] = { 
    DistDocument.decode_ngram_for_counts_field(ngram) 
} 

在这里我想引用另一种方法在同一类,但据我所知有根本没有办法做到这一点。海事组织它应该是明显的东西,如[[encode_ngram]] - 即我绝对不应该需要给一个绝对的类(这将使所有的一切都打破了,只要我拔出一个班,并将其粘在其他地方),我不应该需要如果方法名称本身是明确的(即非多态),则给出参数类型。

回答

18

几个新功能以及许多错误修正即将到来,但目前还没有所有修复程序的确切列表。更值得注意的新功能:

  • 隐性地添加的成员现在将可见。一个很好的例子是看scala.Array,在那里同样map方法,你可能已经假设你现在已经是在Scaladoc可见。
  • 自动生成的SVG继承图,用于查看包级别的类/特性/对象之间的关系,然后还可以查看各个类的级别等。例如,请参见Scaladoc图package-level(点击“Content Hierarchy”)以及class-level
  • 方法链接在一些有限的形式应该进入2.10(不在夜间尚未)。 (如你所注意的,由于像过载这样的实际的东西,实际上并不是完全微不足道的。)
  • 改进的用例带有用例的成员不再是双生成的,它们是现在比以前更清晰简单了。
  • (欠显着)键盘快捷键用于导航Scaladoc已被添加,他们解释herehere

用于修补漏洞的更详尽的列表,这可能是写信给斯卡拉一个好主意-internals--有一个很好的机会在过去的一年里为你编译所有主要错误修正列表。

+1

哇... SVG图表令人印象深刻!谢谢! – soc 2012-07-07 07:22:36

+0

谢谢!这非常有帮助。 – 2012-07-09 05:42:12