Haddock:依存関係グラフの作成に失敗しました( *またはモジュールの見出しを持つセクションを追加するとき)
質問
Tarball Sourceから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と他のソースモジュールを搭載していないLIBにのみ依存することに注意してください。)
ただし、セクションを追加しようとすると 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が(ハドックソースのグレップに従って)何も返していないが、依存関係の分析が失敗しないようにする方法ではないことを私に言うだけであるため、どこから機能し始めるのかわかりません。おそらく、GHC/Base/ContainersドキュメントまたはHaddock構成ファイルのMission Link宛先へのコマンドライン引数または参照が必要ですか?
Googleを検索すると、ハッケージのパッケージについては、同じILKのCABALビルドエラーがたくさんありますが、それらを修正する方法については何も得られませんでした。
セクションを(アスタリスク付き)追加して、ハドックを取得してドキュメントを生成するにはどうすればよいですか?何(おそらく単純なこと)が足りないのですか?
解決
簡単な修正(ひどいエラーメッセージ):
(モジュール名で行まで)を移動します。以前の悪いコード:
module Data.DualMap
-- * The @DualMap@ abstract type
( DualMap ()
-- * (?) internal? -- exposed for testing purposes, for now...
, dmFlip
-- * converting to and from DualMap
, toList, fromList, map
-- * constructing a DualMap
, empty, null, insert, union
幸せなコードは次のようになります:
module Data.DualMap (
-- * The @DualMap@ abstract type
DualMap ()
-- * (?) internal? -- exposed for testing purposes, for now...
, dmFlip
-- * converting to and from DualMap
, toList, fromList, map
-- * constructing a DualMap
, empty, null, insert, union
簡単です。ダウンロードしてこれを見つけました HacakgeのDLIST そして、それを妨害し、コードを自分のコードに置き換えます。 DLISTが「Cabal Haddock」で作業し、私がそうしなかったとき(アスタリスクを追加しようとしたとき)、ファイル間の違いを見て、括弧が間違った線にあることを確認しました。
ところで、私はDLISTを強く強くお勧めします。 hnop.