Haddock：无法创建依赖关系图（添加带有 * 或模块标题的部分时）

Question

我从 tarball 源编译并安装了 haddock-2.4.2。

在此处的代码中添加一些简单的注释：

• https://dl.getdropbox。 com/u/143480/doc/DualMap.hs

并运行 haddock

$ 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

产量：

• https://dl.getdropbox.com/u/143480/doc/Data-DualMap.html

事情看起来不错。 （请注意，此模块仅依赖于 GHC 附带的库，而不依赖于其他源模块。）

但是，当我尝试添加部分时（a la http://www.haskell.org/haddock/doc/html/ch03s04.html#id289234 ) 在注释中带有“-- * test “我得到：

$ 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 没有返回任何内容（根据 haddock 源的 grep），但不告诉我如何阻止依赖关系分析失败。 也许我需要更多的命令行参数或对 GHC/base/containers 文档或某些 haddock 配置文件中缺少的链接目标的引用？

在 Google 上搜索后，发现了大量与 hackage 上的软件包类似的阴谋集团构建错误，但没有提及如何修复它们。

如何添加部分（带星号）并让 Haddock 生成我的文档？ 我错过了什么（可能很简单）？

Answer 1

简单修复（可怕的错误消息）：

将 ( 移到模块名称所在的行。以前的错误代码：

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

足够简单。我通过下载 DList from hacakge 并将其删除并用我自己的代码替换代码。当 DList 与 'cabal haddock' 一起工作而我的没有（当我尝试添加一些星号时），我查看了文件之间的差异，果然我的括号在错误的行上。

顺便说一句，我强烈推荐 DList 作为新 Haskell 项目的起点，而不是 hnop。