11

在进入 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]]——即我绝对不需要给出一个绝对的类（一旦我退出一个类并将它粘在其他地方，这会使一切都中断），我不应该需要给出如果方法名称本身是明确的（即非多态的），则参数类型。

4

1 回答 1

18

一些新功能以及许多错误修复即将推出，但目前还没有所有修复的最终列表。在更显着的新功能中：

  • 隐式添加的成员现在将可见。一个很好的例子是查看scala.Array，map您可能认为您拥有的方法现在在 Scaladoc 中可见。
  • 自动生成的 SVG 继承图，用于鸟瞰包级别以及各个类级别的类/特征/对象之间的关系等。例如，每晚在两个包级别查看 Scaladoc 图表（单击“内容层次结构”）以及类级别的.
  • 某种有限形式的方法链接应该进入 2.10（还没有在 nightly 中）。（正如您所指出的，由于重载等实际问题，以完整形式实现实际上并非完全微不足道。）
  • 改进的用例不再会双重生成具有用例的成员，它们现在比以前更清晰、更简单。
  • （不太显着）已添加用于导航 Scaladoc 的键盘快捷键，它们在此处和此处进行了解释

对于更详尽的错误修复列表，写信给 scala-internals 可能是一个好主意——很有可能有人会在那里为您编译过去一年中所有主要错误修复的列表。

于 2012-07-06T07:42:12.807 回答