将包上传到hackages时没有生成黑线鳕答案

【问题标题】：No haddock generated when upload package to hackages将包上传到hackages时没有生成黑线鳕
【发布时间】：2012-04-29 04:34:52
【问题描述】：

在我将我的包上传到 hackages 后，它并没有像其他包一样生成黑线鳕。

我错过了什么？

我所做的是：

cabal dist 和 dist 目录下生成的包。
打开hackage web upload界面并上传包。
打开URL，发现包上传成功，但没有黑线鳕。（该软件包确实有一些文档）

谢谢。

【问题讨论】：

标签： haskell cabal hackage

【解决方案1】：

生成文档需要一点时间。我相信它们是在格林威治标准时间午夜运行的。

【讨论】：

谢谢托马斯。让我们密切关注。

【解决方案2】：

除了 Thomas 的回答之外，在您的包目录中运行 cabal haddock 并查找任何错误。

根据我的经验，黑线鳕非常挑剔，尤其是 wrt。代码块。如果您遇到解析错误，请开始删除 cmets，直到可以生成文档。我通常使用一些广泛记录的包作为参考。

【讨论】：

【解决方案3】：

似乎缺少文档，因为您的包没有正确构建。我在build log 结尾附近找到了这个：

src/Network/OAuth2/HTTP/HttpClient.hs:18:8:
    Could not find module `Control.Monad.Trans.Resource'
    It is a member of the hidden package `resourcet-0.3.2.1'.
    Perhaps you need to add `resourcet' to the build-depends in your .cabal file.
    Use -v to see a list of the files searched for.

为避免此类问题，请确保在上传之前使用 Cabal 在本地构建您的包。直接使用 GHC 构建通常会掩盖这些问题，因为它会愉快地使用您安装的任何软件包，无论您是否在 .cabal 文件中提到它们。

【讨论】：

实际上我认为这个错误对我没有意义，因为模块 `Control.Monad.Trans.Resource' 是管道的成员。我可以使用 ghc-7.0.2 在本地构建，因此我想知道是否有一种方法可以告诉 Hackages 使用特定版本的 GHC。
我想我找到了原因。我没有指定管道的上限，因此 Hackages 使用最新的删除了Resource API。