haskell - 黑线鳕的差异文档

Question

如果我做 cabal build在我的库上，然后更改一个文件，下次我运行 cabal build ，我只需要重新编译受更改影响的文件。我没有得到与 cabal haddock 相同的行为命令:当我在更改文件后运行它时，cabal/haddock 最终会丢弃所有以前的工作并从头开始。这相当耗时；有没有办法对文档进行差异更新？

这是 dump of the command cabal issues生成文档。

Answer 1

processModules文档说:

Create Interfaces and a link environment by typechecking the list of modules using the GHC API and processing the resulting syntax trees.

这就是 haddock 的核心功能.所以 ATM 你的问题的答案是否定的。
cabal build没有帮助 cabal haddock就像 haddock对具有不同参数的模块进行类型检查(例如 __HADDOCK__ 启用 CPP 变量)

生成可靠的增量黑线鳕是很困难的，因为依赖图中后面的代码可以更改之前的模块文档:特别是实例列表。可能有人可以转储模块接口(interface)。

望 at the code of processModules 第一步是可以逐步做的事情，剩下的就是使用全局信息。

尝试将详细程度调到最大，即 --haddock-options=--verbosity=2并检查 Creating interfaces... 之间花费了多少时间和 Attaching instances... .