11

Scala 2.10 に含まれるさまざまな機能の不完全なリストの中で、Scaladoc の改善についてさまざまな言及があります。しかし、どれが存在し、どれが実際に導入されるかは不明です。たとえば、改善リストの 1 つに「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)
}

同じクラスの別のメソッドを参照したいところですが、私の知る限り、それを行う方法はありません。IMO それは次のような明白なものでなければなり[[encode_ngram]]ません-つまり、絶対クラスを与える必要は絶対にありません(クラスを引き出して別の場所に貼り付けるとすぐにすべてが壊れてしまいます)、与える必要はありませんメソッド名自体があいまいでない (つまり、多態的でない) 場合は、パラメーターの型。

4

1 に答える 1

18

いくつかの新機能と多くのバグ修正が予定されていますが、すべての修正の完全なリストはまだありません. より注目すべき新機能のうち：

  • 暗黙的に追加されたメンバーが表示されるようになりました。良い例は、scala.Arraymapを見ることです。ここでは、あなたが持っていると思っていたようなメソッドがScaladoc に表示されています。
  • 自動生成された SVG 継承図。パッケージレベルでのクラス/特性/オブジェクト間の関係の鳥瞰図と、個々のクラスのレベルでの関係の鳥瞰図など。([コンテンツ階層] をクリック) およびクラス レベルで。
  • いくつかの制限された形式でのメソッドリンクは、2.10 に入る必要があります (ナイトリーにはまだありません)。（実際には、オーバーロードなどの実用的なものがあるため、完全な形で実装するのは簡単ではありません。）
  • 改善されたユース ケース ユース ケースを持つメンバーが二重に生成されることはなくなり、以前よりも少し明確でシンプルになりました。
  • (それほど重要ではありません) Scaladoc をナビゲートするためのキーボード ショートカットが追加されました。こことここで説明されています。

バグ修正の完全なリストについては、scala-internals に投稿することをお勧めします。誰かが過去 1 年間のすべての主要なバグ修正のリストを作成してくれる可能性があります。

于 2012-07-06T07:42:12.807 に答える