問題タブ [scaladoc]

Scala 2.10 に含まれるさまざまな機能の不完全なリストの中で、Scaladoc の改善についてさまざまな言及があります。しかし、どれが存在し、どれが実際に導入されるかは不明です。たとえば、改善リストの 1 つに「Scaladoc への修正」と記載されており、さまざまなプル リクエストへのリンクがあり、そのうちのいくつかは拒否されました。

Scala 2.9 と 2.10 のマイルストーン 4 の間で実際に何が変更されたかを要約して、2.10 自体に他に何が計画されているかを示すことができますか?

また、メソッドにリンクできないという問題は最終的に修正されるのでしょうか? たとえば、コード全体に散らばっていますが、次のようなものがあります。

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

私はスカラが初めてです。私はEclipse Junoを使用しているので、ナイトリービルドをインストールしました。私が直面している問題は、カーソルがクラス/特性上にあり、(Java のように) F2 を押したときに scaladoc が表示されないことです。

私は、 scala-docコンパイルの最初のページとして表示されるルートパッケージをどのように文書化できるのか興味があります。どういうわけかルートパッケージを参照するパッケージオブジェクトを作成できますか、それとも構成オプションはありますか？この問題の説明はやや曖昧です。

5 つのモジュールを持つ親プロジェクトがあります。モジュール レベルの scaladoc を 1 つのまとまりのあるサイトに集約する方法を見つけようとしています。どんな助けでも大歓迎です。

Scaladocが次のコードスニペットの型階層図を生成するようにしたいと思います。

しかし、実行scaladoc <file>.scalaすると、タイプ階層は表示されません-inにAもinにも表示されませんB。どうすればそのような図を生成できますか？

sbtコマンドを使用してscaladocを生成しdocます。生成されたscaladocのデフォルトの順序はに設定されていますAlphabetic。手動でに変更できますBy inheritanceが、別のクラスのドキュメントにアクセスすると、順序がに戻りますalphabetic。

デフォルトの順序を設定してscaladocを生成する方法はありますBy inheritanaceか？

Scaladocを設定した後、IDEからまだいくつかのドキュメントが欠落していることがわかります

私には（これに気付いてくれたPeterに感謝します）次のように思われます：

• 太字以外のフォントの関数にはドキュメントがありません
• 太字の関数は最小限です
• 下線付きの関数には完全なドキュメントがあります

ドキュメントなし（通常の非太字フォント）

最低限のドキュメント（太字）

完全なドキュメント（下線付き）

ちなみに、私のscaladocは次のようにインストールされています

次のように構成されています。

編集：

OracleからJavadocをダウンロードし、/Library/Scala/2.10.0-RC2/doc/javadoc

IDEAにさらに1つのエントリを追加しました：

役に立たないようです。

どうか明らかにしてください

SBT で Scaladoc を構成しようとしています。具体的には、タイトル、出力ディレクトリ、およびクラスパスです。

build.sbt に以下を追加して、タイトルを定義することができました。

ドキュメント出力ディレクトリを変更する方法がわかりません。

クラスパスにjarを追加する方法もわかりません。クラスパスを編集したい理由は、標準の Scala ライブラリがそのクラスを参照するときに scaladoc によって取得されていないように見えるためです。つまり、[[scala.Option]] は「リンクするメンバーが見つかりませんでした」という警告につながります。 「scala.Option」の場合。

SBT構成の例の形であっても、助けていただければ幸いです!

Scala 2.10-RC3 と SBT 0.12.1 を使用しています。

言う、私はreduceLeftメソッドがに適用されたときに何をするのかをよりよく理解しようとしていますArray[String]

スカラドックは言う：

わかりました、もう一度質問する必要があります、この方法は何をしますか？そして、もっと重要なことは、私がそれを教えてくれるのにscaladocに頼ることができない場合、どこで見つけることができますか？

サードパーティライブラリの外部ドキュメントへのリンクを生成するために、Scaladocコメントを検索して置換する短いBashスクリプトがあります。タスクを使用してScaladocsを生成するたびに、このスクリプトを実行したいと思いdocます。

どうすればこれを達成できますか？