tarball ソースから haddock-2.4.2 をコンパイルしてインストールしました。
ここのコードにいくつかの簡単なコメントを追加します。
ハドックを実行しています
$ haddock -h -o doc Data/DualMap.hs
Warning: Data.DualMap: could not find link destinations for:
Data.Typeable.Typeable2 GHC.Base.Eq GHC.Show.Show GHC.Base.Ord GHC.Base.Bool Data.Set.Set
収量:
物事は良さそうです。(このモジュールは、GHC に同梱されているライブラリにのみ依存し、他のソース モジュールには依存しないことに注意してください。)
ただし、「-- * test」を使用してコメントにセクション (a la http://www.haskell.org/haddock/doc/html/ch03s04.html#id289234 ) を追加しようとすると、次のようになります。
$ haddock -h -o doc Data/DualMap.hs
Data/DualMap.hs:20:0: parse error on input `-- * test'
haddock: Failed to create dependency graph
このエラー メッセージは Haddock.Interface.depanal が (hadock ソースの grep によると) Nothing を返したことだけを示しており、依存関係の分析が失敗するのを止める方法は示していないため、これを機能させるにはどこから始めればよいかわかりません。おそらく、GHC/base/containers のドキュメントや Haddock の設定ファイルで不足しているリンク先へのコマンド ライン引数や参照が必要でしょうか?
Google を検索すると、ハックのパッケージについて同じ同類の多数の cabal ビルド エラーが得られましたが、それらを修正する方法については何もありませんでした。
セクション (アスタリスク付き) を追加し、Haddock にドキュメントを生成させるにはどうすればよいですか? 私が見逃しているもの (おそらく単純なもの) は何ですか?