6

Scala ドキュメンテーションを作成するときは、ここ (Scaladoc Wiki - タグと注釈) に記載されているようにタグ@throwsとタグも使用します。@note

残念ながら、生成されたScaladocでこれらを見つけることができません。

特定のスイッチを設定する必要がありますか、特定のものを検討する必要がありますか、それとも既知の問題ですか?

ところで：警告も発行しないScala 2.9.0.1のscaladoc Antタスクを使用しています。

EDIT：@throws BTW2と明確にするために：私は注釈を意味するものではありません

@throws(classOf[RuntimeException])
def dispatch: Nothing = throw new RuntimeException

これはこの注釈セクションに記載されていますdefが、@throwsScaladoc のタグは

/** @throws RuntimeException
 */
def dispatch: Nothing = throw new RuntimeException
4

2 に答える 2

3

これは、バグと、まだリリースされていないものの組み合わせです。

@note が機能しません。これは既知のバグです。@todo、@note、@example が機能しないのを参照してください。

@throws は最近追加されたばかりです。2011 年 7 月にマージされたSimon Ochsenreitherからのこのプル リクエストを参照してください。これはまだリリースされておらず、2011 年 5 月に 2.9.0.1 がリリースされ、7 月に 2.9.1 が開始されました。 2011年。

于 2011-09-13T11:12:59.290 に答える
3

半年前にサポート@noteを追加しました。

ここを見ると、正しく動作しているようです: scala.util.matching.Regex

それ以外は@throwsScalaDoc タグです。実際、サポートされているアノテーションを優先してサポートを削除することを考えています。これは、@throwsアノテーションよりも ScalaDoc タグを好むユースケースが見当たらないためです。

本当に必要な場合は、私に連絡してください。

編集：うーん。scala.Arrayを見ると、実際には逆のように見えます...

于 2011-09-13T11:13:07.180 に答える