問題タブ [haddock]

hsc2hs を使用して、C ヘッダーから多数の列挙値をインポートしています。私のコード（簡略化）は次のようになります。

プロジェクトで実行すると、宣言とtype のcabal haddock空のドキュメント ブロックが作成されます。今、私はこれらのドキュメントを持っていたいと思っています。次のようなハドックスタイルのコメントを使用するだけですsecurityObjectUnknownsecurityObjectFileSecurityObjectType

hsc2hs に干渉し、ビルドが失敗します。しかし、私はこれらの宣言を文書化したいと考えています。どうすればそれができますか？

UPD: コメントがある場合、ビルド中に生成されるエラー メッセージは次のとおりです。

単純化した例のため、実際には行番号は一致しませんが、エラー出力の 47 行目は-- | Unknown object type行に対応しています。

生成されSecurityInfo_hsc_make.cたファイルを掘り下げると、明らかに問題が示されます (ここにフラグメントがあります)。

Haskell コメントは、生成された C ファイルに単純に挿入されますが、これは明らかに C 構文規則に違反しています。私が望んでいたのは、これらのコメントが自動生成された.hsファイルに反映されるようにすることです。

Unix で pandoc を使用するための検索で、私の SLES11 OS には既に GHC がインストールされていることがわかり、Cabal パッケージが実際にそこにあることがわかりました。しかし、cabal コマンドが見つからないので、cabal をインストールしてみました。ブートストラッパーを実行すると、Haddock が見つからないというメッセージが表示されます (Haddock.hs は Distribution フォルダーに表示されるため、見つからない理由はわかりません)。これは、すでに GHC にインストールされている Cabal パッケージをアクティブ化するために使用できる簡単なセットアップ コマンドがあるかどうか疑問に思います?? それを実行したら、Windows で既に使用している Pandoc を使用したいと考えています。

Haddock を使用してプロジェクトの LaTex ドキュメントを生成しようとしています。すべてがビルドされていcabalます（...cabal configureそしてcabal build問題なく動作します）。ドキュメントのhtmlバージョンでは、すべてが正常に機能します。

しかし、発行cabal haddock --haddock-option=--latexすると、まだhtmlがビルドされます:

フォルダーにいくつかの*.texファイルがダンプされdist/doc/html/my_project/ます。生成された出力が壊れているようです。ビルドしようとするmy_project.texとpdflatex、大量のエラー メッセージが表示されます。

私は何か重要なものを見逃していますか？そして、それは通常の方法texですか -files からマニュアル (またはスクリプト) でドキュメントを作成する必要がありますか?

相互に依存するインポートのため、モジュール内のクラス インスタンスとInstancesモジュール内のデータ型を移動する必要がありましたTypes。その後、2 つのモジュールの両方の定義が、パッケージのメイン モジュールによって再エクスポートされます。

私のタイプのハドックは、派生したクラスインスタンスをリストしますderivingが、他のすべてが欠落しています (ただし、それらは正しくエクスポートされ、機能しているように見えます)。それは正常ですか、それともリストに記載する必要がありますか? 私に何ができる？

必要な場合は、このパッケージです。

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

このコメントによると、インストールするパッケージのソースに cabal-install をハイパーリンクさせることもできます。論文のソースはどこに置くのですか？それらを取得するために他のオプションまたはパッケージを有効にする必要がありますか?

Windows 8 で Stack 0.1.3.1 を使用して新しい Haskell プロジェクトを作成しています。stack.yamlファイルは次のようになります。

stack buildまたはを実行するとstack test、すべてが美しく機能します。haddockコマンドラインから手動で実行でき、それも機能します。しかし、実行するstack haddockと、次のような出力が得られます。

明らかにこれはナンセンスです —特に、LTS パッケージ セットで作業しているので、base自分のに追加する必要はありません! extra-depsここで何が起こっているのですか？

更新:以下の回答で説明されているように、これはスタックのバグのようで、新しいバージョンで修正する必要があります。https://github.com/fpco/minghc/issues/85を参照してください。