問題タブ [scaladoc]
For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.
lazy-evaluation - scala には、1 回またはまったく評価されない遅延サンクのクラスがありますか?
シンプルなもの
どこかで定義されていますか?
あるいはもう少し洗練された
scala - scaladocのメソッドへのリンクを明確にする方法は?
オーバーロードされたメソッドを持つ Scala クラスを文書化しています。scaladoc コメントでそれらを参照する場合、どうすればそれらを区別できますか? たとえば、私が持っている場合
実行しsbt doc
て取得します
Doc.scala:1: 警告: リンク ターゲット "Doc.foo" があいまいです。いくつかの (おそらくオーバーロードされた) メンバーがターゲットに適合します。
foo[A,B>:A](x:A):B
オブジェクトDocのメソッド[選択]foo[A]:Nothing
オブジェクト Doc のメソッド
リンクへの使用foo[A,B >: A]
などは機能しません。
scala - scaladoc にデフォルトのパラメータ値を表示させる方法は?
私は多くの方法を持っています
しかし、(sbt を使用して) scaladoc を実行するとrunFinalizer
、デフォルト値を持つドキュメントが表示されません。false
ユーザーがパラメータを設定することはめったになく、生成されたドキュメントには省略できることが示されていないため、これは非常に問題です。
これまでのところ、2 つの解決策がありますが、どちらも完全に満足できるものではありません。
runFinalizer
ブロック内で省略できる事実を文書化し@param
ます。これは役に立ちますが、ドキュメントの多くの場所でそのような文が重複することになり、ユーザーが見落とす可能性があります。- メソッドの 2 つのバリアントを作成します。1 つはあり
runFinalizers
(デフォルト値なし)、もう 1 つはなしです。しかし、これはメソッドの数を不必要に 2 倍にし、コードとドキュメントの両方を混乱させます。
eclipse - Eclipse プロジェクトから Scaladocs を生成する方法
Eclipse プロジェクトから scaladoc の生成を開始したいと考えています。私は SBT を使用していませんが、必要に応じて Eclipse プロジェクトを sbt にインポートしたいと考えています。
eclipse Scala プロジェクトから Scaladoc を生成するにはどうすればよいですか?
scala - Scala API をブラウズするのが難しいのはなぜですか?
#::
まず、ストリームの方法を見つけるのに問題がありました。thisから解決されたもの。
今、私は以下の方法を探していますStream
Stream APIにはそれについての言及がありません。
第二に、Scala Doc では、同じそれぞれの親クラス自体ですべての内部クラスを定義できないのはなぜですか。Stream.consWrapperをドキュメント内で直接読むことができるのにc
、左パネルの文字をクリックしてStream.consWrapperStream
を検索する必要があるのはなぜですか?
何か不足していますか?私は Scala の初心者 (3 か月) ですが、新しいユーザーが慣れることができなければ、ほとんどのことはできません。
scala - scaladoc はルートドキュメントを作成するために rootdoc.txt をどこで探しますか?
これはGenerate scaladoc for root packageの複製ですが、Answersbt doc
にはrootdoc.txt
.
追加した
私のbuild.sbt
に、しかしsbt doc
それをスキャンしていないようです。build.sbt
、 、 、src
の隣に置いてみましたsrc/main
。src/main/scala
私は使っているsbt 0.12.3
java - JDK のクラスを scaladoc で生成されたドキュメントにリンクする方法は?
JDK のクラスを scaladoc で生成されたドキュメントにリンクしようとしています。-doc-external-doc
scaladoc 2.10.1のオプションを使用しましたが、成功しませんでした。
を使用していますが、代わりに の-doc-external-doc:/usr/lib/jvm/java-7-openjdk-amd64/jre/lib/rt.jar#http://docs.oracle.com/javase/7/docs/api/
ようなリンクが表示されます。このオプションは、scaladoc で生成されたドキュメントに対してのみ機能するようです。index.html#java.io.File
index.html?java/io/File.html
scaladoc のオプションを見逃していましたか、それとも機能リクエストに記入する必要がありますか?
次のようにsbtを構成しました。
注: 私はOpts.doc.externalAPI
次の sbt 0.13 でこのユーティリティを見てきました。ModuleID
a の代わりに aを渡すのが良い追加 (可能かどうかはわかりません) だと思いますFile
。util は、どのファイルがModuleID
.
scala - HashMap.toArray が Array[(A,B)] ではなく Array[A] を返すと scaladoc が言うのはなぜですか?
toArray
for hashmapsの定義を見ていました:
http://www.scala-lang.org/api/current/index.html#scala.collection.immutable.HashMap
それは持っています
私はこれをよく理解していません.最初のビットはArray[A]を取得すると言っていますが、2番目の部分はArray[B]を取得すると言っています? これらはどちらも私が期待するものではありません - Array[(A,B)]
自分で確認すると:
なぜtoListに似ていないのですか?