Haskell cabal:生成latex haddock文档

Question

我正在尝试通过cabal和haddock生成API文档。我想要的是乳胶。所以我这么做了：

cabal haddock --haddock-option=--latex

这最终会失败，原因是：

haddock: internal error: declaration not supported by declNames

有没有什么我能做的或者黑线鳕鱼有什么问题？

仅供参考，我必须使用cabal，因为构建过程相当复杂(有很多预处理器、ffi库等)。手动调用haddock真的很痛苦。

但是，构建HTML文档的工作完全符合预期。

完整的输出在http://pastebin.com/xt6rWqde上。

我正在使用：

cabal-install version 0.14.0
using version 1.14.0 of the Cabal library 

The Glorious Glasgow Haskell Compilation System, version 7.4.2

Haddock version 2.11.0, (c) Simon Marlow 2006
Ported to use the GHC API by David Waern 2006-2008

Answer 1

declNames :: LHsDecl DocName -> [DocName]
declNames (L _ decl) = case decl of
  TyClD d  -> [unLoc $ tcdLName d]
  SigD (TypeSig lnames _) -> map unLoc lnames
  _ -> error "declaration not supported by declNames"

因此，LaTeX后端只支持类型类声明和类型签名，传递给declNames的所有其他内容都会生成"declaration not supported by declNames"错误。

ForD d                         -> ppFor summ links loc (mbDoc, fnArgsDoc) d unicode qual
InstD _                        -> noHtml

外部声明生成输出，实例声明不生成输出。不支持的声明导致

error "declaration not supported by ppDecl"

在ppDecl (Haddock.Backends.Xhtml.Decl)中。

实例声明不会传递给LaTeX后端中的declNames，因此它们不会生成错误，但外部声明会(如果导出)。

因为你的模块是Foreign.Java.X的，所以我希望从某个模块导出一些外来的im- or导出，这就解释了这个错误。

似乎需要一个bug报告/功能请求。