問題タブ [haddock]

私は自分のプロジェクトをコンパイルするための Cabal-install の代替品を作成中です (興味がある場合はGithubを参照してください)。ほぼ完全に機能するようになりましたが、1 つの詳細については: 個別のパッケージのドキュメントを生成するとき、Haddock は他のパッケージによって生成されたインターフェイス ファイルを読み取っても、他のパッケージの HTML 宛先を見つけることができないようです。

私のビルドシステムが Haddock に対して行う呼び出しと、それに付随する出力は次のとおりです。

--read-interface私はまた、次のようなフラグを書くためのほとんどすべての可能な方法を試しました:

• ビルド ディレクトリへの相対パスとして
• file://URLとして
• HTML リンク ディレクトリを示すと想定される 0、1、および 2 のプレフィックスを使用

ファイルが存在しない場合に Haddock が失敗するため、インターフェイス ファイルが正しく読み取られていることはわかっています。また、HTML ファイルを参照しているため、HTML ファイルが適切な場所にあることもわかっています。それらを見ないでください。

この状況はほぼ 2 か月間私を悩ませてきました。ドキュメントにハイパーリンクがない生活の灰色を受け入れることを学びました。

御時間ありがとうございます、

Haddock を使用してクラス メソッドをドキュメント化し、インスタンス宣言コードでドキュメントの一部をクエリすることは可能ですか?

たとえば、クラスを次のように文書化したいと思います。

およびこのように文書化されたインスタンス：

html Haddock のドキュメントを次のように取得します (申し訳ありませんが、画像がありません)。

メソッドのドキュメント全体をスタンドアロンの段落に保持しながら、インスタンスにパターンを追加する場合、ドキュメントのこの編成はより読みやすく、拡張しやすくなります。出来ますか？

Haddock バージョン 2.10.0 を使用しています。Debian 7.0 で。

ご協力ありがとうございました。

ソース コードの方程式にラテックス表記を使用したいと考えています。たとえば、haskell ソース ファイルの Equations.hs に次のコメントを書きます。

ディレクトリではdoc、これは Haddock によって Equations.tex として次のようにレンダリングされます。

Haddock のラテックス バックエンドのソースで、ラテックス形式で使用される多くの文字を置き換えるこの関数を見つけました。

これをバイパスしてラテックス方程式をコメントに挿入できる既存の機能はありますか?

多くの haskell パッケージがあり、haddock ドキュメントを生成できるようにいくつかのフラグを有効にしました。現在、これらのドキュメントは のようなディレクトリの下にあり/usr/share/doc/{package-name}-{version}/html/ます。

それらを整理するツールはありますか？これらのインストールされたすべてのパッケージへのローカルリンクが1つのページで見つかるように、hackageの名前ページによるすべてのパッケージのようなものが欲しいです。

hoogle にこれらのドキュメントを使用するように指示できるとよいでしょう。今では、私のフーグル検索結果はすべて、ハックの対応するページを指しています。

Haddock 用に注釈を付けようとしている、長いタプルを含む Haskell 関数シグネチャがあります。

タプル メンバーのコメントを Haddock マークアップ (-- ^以前の引数の型と同様) に変換すると、Haddock は解析エラーで停止します。これは単なる制限であり、それについては何もできないことを示唆するコメントをいくつか見つけました。そうですか？かなり悪いです。ドキュメントと概要バーの両方が画面の端からはみ出し、判読できません。Haddock を満たすためだけに、タプルの代わりに別の型を導入したくはありません。

ありがとう！

(更新: これが現在サポートされていないことを確認するオープンな Haddock機能要求があります。そこに +1 を追加しましたが、誰かがパッチまたは回避策を持っているかどうかに興味があります。)

私のHaskellファイル（これが問題ではないことは確かです）は基本的に次のとおりです。

私のSetup.hs：

私のgrade.cabal：

私が走るとき、私cabal haddock --executablesは得る

HTMLにはドキュメントが含まれていますmainが、ドキュメントは含まれていません。以外に定義した関数すら含まれていませんmain。何故ですか？

すべての可能なもののリストがあるとしましょう

これで、整数Nと 2 つの戦略を取り、最初の戦略をN時間に使用し、次に 2 番目の戦略をN時間に使用して、必要なだけ繰り返し続ける別の関数ができました。
が 0の場合はどうなりますかN。関数の目的に反するため、ランダムな戦略を返したいのですが、最終的には特定の戦略を適用する必要があります。

だから私はリストからランダムな戦略を取得しようとしています. これでうまくいくと思います：

しかし、Haddock/doctest を使用してテストするにはどうすればよいでしょうか?

ランダム関数は Haskell の関数型の考え方に反するものだと思いますが、私も間違っている可能性があります。命令型言語では、random 関数はさまざまなパラメーター (Java の Time など) を使用して乱数を決定します。