Scala 2.10中Scaladoc中添加了哪些新功能(或将会添加)？

Question

在进入Scala 2.10的所有各种不完整的功能列表中,Scaladoc有各种改进提及.但目前还不清楚有哪些,以及哪些实际进入 - 例如,其中一个改进列​​表称"修复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)
}

我想在同一个类中引用另一个方法,但是AFAIK根本就没办法做到这一点.IMO它应该是显而易见的东西[[encode_ngram]]- 也就是说我绝对不需要给出一个绝对的类(一旦我拿出一个类并将其粘贴在其他地方就会使一切都中断),我不应该给如果方法名称本身是明确的(即非多态的),则为参数类型.

Answer 1

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

• 现在可以看到隐式添加的成员.一个很好的例子是查看scala.Array,map你可能已经假设的方法现在可以在Scaladoc中看到.
• 自动生成的SVG继承图,用于鸟瞰包级别的类/特征/对象之间的关系,然后也可以在各个类的级别等.例如,每晚在包级别查看Scaladoc图(单击"内容层次结构")以及类级别.
• 某种有限形式的方法链接应该进入2.10(不是在夜间).(正如你所指出的那样,由于像重载这样的实际问题,以完整的形式实现并不是完全无足轻重的.)
• 改进的用例具有用例的成员不再生成,现在它们比以前更清晰,更简单.
• (不太值得注意)添加了用于导航Scaladoc的键盘快捷键,这里和这里都有解释

对于更详尽的错误修正列表,写入scala-internals可能是一个好主意 - 很可能有人会在那里为你编译过去一年中所有主要错误修正的列表.